From 7395fd6bfe09b196cb929f9ebc846fffeba8ad2c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E1=B4=85=E1=B4=9Cx=E1=B4=9B=E1=B4=80=E1=B4=8D=C9=AA?= <141910400+duxtami@users.noreply.github.com> Date: Sun, 12 Apr 2026 20:37:04 +0530 Subject: [PATCH 1/4] Revise README for clarity and additional details Updated README to enhance project description, features, tech stack, project structure, and installation instructions. --- README.md | 99 ++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 62 insertions(+), 37 deletions(-) diff --git a/README.md b/README.md index d47b19c..744218d 100644 --- a/README.md +++ b/README.md @@ -1,57 +1,82 @@ -# LastWave – Last.fm Playlist Generator +LastWave -A Material You Android app that generates playlists from your Last.fm history. +LastWave is an Android application built around the Last.fm ecosystem to help users track, analyze, and interact with their listening data. + +The app focuses on simplicity, speed, and practical features rather than visual complexity. --- -## Setup in Android Studio +Features + +- View listening statistics (scrobbles, tracks, artists) +- Track recent and currently playing songs +- Generate playlists based on listening history +- Search tracks, artists, and albums +- Explore music using genres and recommendations +- Export generated playlists + +--- -### Option A: Copy-paste into existing project -1. Open Android Studio → New Project → Empty Views Activity -2. Package name: `com.lastwave.app` -3. Replace the generated `app/` folder with the one from this zip -4. Replace `build.gradle` (root) and `settings.gradle` with the ones from this zip -5. Sync Gradle → Run +Tech Stack -### Option B: Open as project -1. Open Android Studio -2. File → Open → select the `LastWave/` folder -3. Let Gradle sync -4. Run on device or emulator +- JavaScript (application logic) +- HTML / CSS (UI) +- Android WebView (container) +- Last.fm API --- -## Getting a Last.fm API Key +Project Structure -1. Go to https://www.last.fm/api/account/create -2. Fill in App name: `LastWave`, anything for description -3. Copy the **API key** -4. Open the app → Settings → paste the key → Save +. +├── index.html +├── app.js +├── app.css +├── nav.js +├── home/ +├── generator/ +├── playlist/ +├── settings/ +├── search/ +└── genres/ --- -## Playlist Modes +Screenshots + +Place screenshots inside a "screenshots/" folder. + +Example: + +screenshots/home.png +screenshots/playlist.png +screenshots/search.png + +Then reference them in the README: -| Mode | Description | -|------|-------------| -| Top Tracks | Your most-played tracks (choose time period) | -| Recent Tracks | Latest scrobbles | -| Similar Tracks | Tracks similar to a seed track | -| Similar Artists | Top tracks from artists similar to a seed artist | -| By Tag | Top tracks for a genre/tag (rock, lofi, jazz…) | -| My Mix | Smart blend of all of the above | +

+ + + +

+ +--- + +Installation + +git clone https://github.com/YOUR_USERNAME/LastWave.git + +Open the project in Android Studio and run it on a device or emulator. + +--- -## Export Options +Notes -- **CSV** – Opens share sheet, save anywhere -- **M3U** – Standard playlist file for media players -- **Share** – Text list via any app (WhatsApp, notes, etc.) -- **You Tube** – Searches the first track on You Tube +This project uses the Last.fm API for data. +All data belongs to their respective owners. --- -## Build via GitHub Actions +License -1. Push this folder to a GitHub repository -2. Actions tab → "Build LastWave APK" → Run workflow -3. Download the APK artifact when complete +No license specified. From 83e7d40ce27a532b1ae22565badb014edfa521bf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E1=B4=85=E1=B4=9Cx=E1=B4=9B=E1=B4=80=E1=B4=8D=C9=AA?= <141910400+duxtami@users.noreply.github.com> Date: Sun, 12 Apr 2026 20:38:28 +0530 Subject: [PATCH 2/4] Revise README content and formatting Updated README to improve clarity and structure. --- README.md | 63 ++++++++++++++++++++++++------------------------------- 1 file changed, 27 insertions(+), 36 deletions(-) diff --git a/README.md b/README.md index 744218d..c24813d 100644 --- a/README.md +++ b/README.md @@ -1,27 +1,38 @@ -LastWave +

LastWave

+A lightweight Android music companion built around Last.fm +

--- -LastWave is an Android application built around the Last.fm ecosystem to help users track, analyze, and interact with their listening data. +Overview -The app focuses on simplicity, speed, and practical features rather than visual complexity. +LastWave helps you work with your listening data in a practical way. +It focuses on speed, clarity, and useful features instead of unnecessary complexity. --- Features -- View listening statistics (scrobbles, tracks, artists) -- Track recent and currently playing songs -- Generate playlists based on listening history -- Search tracks, artists, and albums -- Explore music using genres and recommendations -- Export generated playlists +- Listening statistics (scrobbles, tracks, artists) +- Recent and now playing tracking +- Playlist generation based on your data +- Search for tracks, artists, and albums +- Genre-based exploration +- Playlist export support --- +Screenshots + +

+ + + +

--- + Tech Stack -- JavaScript (application logic) -- HTML / CSS (UI) -- Android WebView (container) +- JavaScript +- HTML / CSS +- Android WebView - Last.fm API --- @@ -42,41 +53,21 @@ Project Structure --- -Screenshots - -Place screenshots inside a "screenshots/" folder. - -Example: - -screenshots/home.png -screenshots/playlist.png -screenshots/search.png - -Then reference them in the README: - -

- - - -

- ---- - Installation git clone https://github.com/YOUR_USERNAME/LastWave.git -Open the project in Android Studio and run it on a device or emulator. +Open in Android Studio and run the project. --- Notes -This project uses the Last.fm API for data. -All data belongs to their respective owners. +Uses Last.fm API for data. +All rights belong to respective owners. --- License -No license specified. +Not specified. From 95038b168f6634d43bae4aee44f244026f4758c3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E1=B4=85=E1=B4=9Cx=E1=B4=9B=E1=B4=80=E1=B4=8D=C9=AA?= <141910400+duxtami@users.noreply.github.com> Date: Sun, 12 Apr 2026 20:41:43 +0530 Subject: [PATCH 3/4] Revise README with setup and feature updates Updated README to reflect new features, setup instructions, and API key acquisition process. --- README.md | 90 +++++++++++++++++++++++-------------------------------- 1 file changed, 37 insertions(+), 53 deletions(-) diff --git a/README.md b/README.md index c24813d..68ecedd 100644 --- a/README.md +++ b/README.md @@ -1,73 +1,57 @@ -

LastWave

-A lightweight Android music companion built around Last.fm -

--- +

LastWave

# LastWave – Last.fm Playlist Generator -Overview - -LastWave helps you work with your listening data in a practical way. -It focuses on speed, clarity, and useful features instead of unnecessary complexity. - ---- - -Features - -- Listening statistics (scrobbles, tracks, artists) -- Recent and now playing tracking -- Playlist generation based on your data -- Search for tracks, artists, and albums -- Genre-based exploration -- Playlist export support +A Material You Android app that generates playlists from your Last.fm history. --- -Screenshots +## Setup in Android Studio -

- - - -

--- +### Option A: Copy-paste into existing project +1. Open Android Studio → New Project → Empty Views Activity +2. Package name: `com.lastwave.app` +3. Replace the generated `app/` folder with the one from this zip +4. Replace `build.gradle` (root) and `settings.gradle` with the ones from this zip +5. Sync Gradle → Run -Tech Stack - -- JavaScript -- HTML / CSS -- Android WebView -- Last.fm API +### Option B: Open as project +1. Open Android Studio +2. File → Open → select the `LastWave/` folder +3. Let Gradle sync +4. Run on device or emulator --- -Project Structure +## Getting a Last.fm API Key -. -├── index.html -├── app.js -├── app.css -├── nav.js -├── home/ -├── generator/ -├── playlist/ -├── settings/ -├── search/ -└── genres/ +1. Go to https://www.last.fm/api/account/create +2. Fill in App name: `LastWave`, anything for description +3. Copy the **API key** +4. Open the app → Settings → paste the key → Save --- -Installation - -git clone https://github.com/YOUR_USERNAME/LastWave.git +## Playlist Modes -Open in Android Studio and run the project. - ---- +| Mode | Description | +|------|-------------| +| Top Tracks | Your most-played tracks (choose time period) | +| Recent Tracks | Latest scrobbles | +| Similar Tracks | Tracks similar to a seed track | +| Similar Artists | Top tracks from artists similar to a seed artist | +| By Tag | Top tracks for a genre/tag (rock, lofi, jazz…) | +| My Mix | Smart blend of all of the above | -Notes +## Export Options -Uses Last.fm API for data. -All rights belong to respective owners. +- **CSV** – Opens share sheet, save anywhere +- **M3U** – Standard playlist file for media players +- **Share** – Text list via any app (WhatsApp, notes, etc.) +- **You Tube** – Searches the first track on You Tube --- -License +## Build via GitHub Actions -Not specified. +1. Push this folder to a GitHub repository +2. Actions tab → "Build LastWave APK" → Run workflow +3. Download the APK artifact when complete From 6cf7b78728087734c7d88d48eb7de9a69f778454 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E1=B4=85=E1=B4=9Cx=E1=B4=9B=E1=B4=80=E1=B4=8D=C9=AA?= <141910400+duxtami@users.noreply.github.com> Date: Sun, 12 Apr 2026 20:43:03 +0530 Subject: [PATCH 4/4] Enhance README with header and formatting updates Added a header and improved formatting in the README. --- README.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 68ecedd..c8ec0b5 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,6 @@ -

LastWave

# LastWave – Last.fm Playlist Generator +

LastWave

+ +# LastWave – Last.fm Playlist Generator A Material You Android app that generates playlists from your Last.fm history. @@ -55,3 +57,4 @@ A Material You Android app that generates playlists from your Last.fm history. 1. Push this folder to a GitHub repository 2. Actions tab → "Build LastWave APK" → Run workflow 3. Download the APK artifact when complete +4.