diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 04ade01e..1129349f 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -309,32 +309,22 @@ jobs:
steps:
- name: Checkout repository
uses: actions/checkout@v6
+ with:
+ fetch-depth: 0 # Full history needed for git-cliff
- - name: Extract changelog for version
+ - name: Generate changelog with git-cliff
id: changelog
+ uses: orhun/git-cliff-action@v4
+ with:
+ config: cliff.toml
+ args: --latest --strip header
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ OUTPUT: /tmp/changelog.txt
+
+ - name: Show generated changelog
run: |
- VERSION=${{ needs.get-version.outputs.version }}
- VERSION_NUM=${VERSION#v} # Remove 'v' prefix
-
- echo "Looking for version: $VERSION_NUM"
-
- # Extract changelog section for this version using sed
- # Find the line with version, then print until next version header or end
- CHANGELOG=$(sed -n "/^## \[$VERSION_NUM\]/,/^## \[/{ /^## \[$VERSION_NUM\]/d; /^## \[/d; p; }" CHANGELOG.md)
-
- # If no changelog found, use default message
- if [ -z "$CHANGELOG" ]; then
- echo "No changelog found for version $VERSION_NUM"
- CHANGELOG="See CHANGELOG.md for details."
- else
- echo "Found changelog content"
- # Remove trailing --- separator if present (CHANGELOG uses --- between versions)
- CHANGELOG=$(echo "$CHANGELOG" | sed '/^---$/d')
- fi
-
- # Save to file for multiline support
- echo "$CHANGELOG" > /tmp/changelog.txt
- echo "Extracted changelog:"
+ echo "Generated changelog:"
cat /tmp/changelog.txt
- name: Download Android APK
@@ -352,15 +342,13 @@ jobs:
- name: Prepare release body
run: |
VERSION=${{ needs.get-version.outputs.version }}
- cat > /tmp/release_body.txt << 'HEADER'
- ### What's New
- HEADER
-
- cat /tmp/changelog.txt >> /tmp/release_body.txt
-
REPO_OWNER="${{ github.repository_owner }}"
REPO_NAME="${{ github.event.repository.name }}"
-
+
+ # Start with git-cliff changelog
+ cp /tmp/changelog.txt /tmp/release_body.txt
+
+ # Append download section
cat >> /tmp/release_body.txt << FOOTER
---
@@ -404,6 +392,8 @@ jobs:
steps:
- name: Checkout repository
uses: actions/checkout@v6
+ with:
+ fetch-depth: 0
- name: Download Android APK
uses: actions/download-artifact@v7
@@ -417,52 +407,40 @@ jobs:
name: ios-ipa
path: ./release
- - name: Extract changelog for version
+ - name: Generate changelog with git-cliff for Telegram
+ uses: orhun/git-cliff-action@v4
+ with:
+ config: cliff.toml
+ args: --latest --strip all
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ OUTPUT: /tmp/cliff_tg.txt
+
+ - name: Convert changelog for Telegram
id: changelog
run: |
- VERSION=${{ needs.get-version.outputs.version }}
- VERSION_NUM=${VERSION#v}
-
- # Extract changelog, limit to ~2500 chars for Telegram (4096 limit minus message overhead)
- # Use tr -d '\r' to handle CRLF line endings from Windows
- FULL_CHANGELOG=$(cat CHANGELOG.md | tr -d '\r' | sed -n "/^## \[$VERSION_NUM\]/,/^## \[/{ /^## \[$VERSION_NUM\]/d; /^## \[/d; p; }" | sed '/^---$/d')
-
- echo "DEBUG: Extracted changelog length: ${#FULL_CHANGELOG}"
- echo "DEBUG: First 200 chars: ${FULL_CHANGELOG:0:200}"
-
- if [ -z "$FULL_CHANGELOG" ]; then
- CHANGELOG="See release notes on GitHub for details."
+ if [ ! -s /tmp/cliff_tg.txt ]; then
+ echo "See release notes on GitHub for details." > /tmp/changelog.txt
else
- # Convert GitHub Markdown to Telegram HTML:
- # - **text** → text
- # - `code` → code
- # - ### Header → Header
- # - Escape HTML special chars first
- # - Remove > blockquote prefix
- CHANGELOG=$(echo "$FULL_CHANGELOG" | \
- sed 's/^> //' | \
+ # Convert Markdown to Telegram HTML
+ CHANGELOG=$(cat /tmp/cliff_tg.txt | \
+ sed '/^\*\*Full Changelog\*\*/d' | \
+ sed 's/\[#\([0-9]*\)\]([^)]*)/#\1/g' | \
+ sed 's/\[@\([^]]*\)\]([^)]*)/@\1/g' | \
sed 's/&/\&/g' | \
sed 's//\>/g' | \
- sed 's/`\([^`]*\)`/\1<\/code>/g' | \
sed 's/\*\*\([^*]*\)\*\*/\1<\/b>/g' | \
sed 's/^### \(.*\)$/\1<\/b>/g' | \
sed 's/^## \(.*\)$/\1<\/b>/g' | \
- sed 's/^- /• /g' | \
- sed 's/^ - / ◦ /g')
-
- # Take first 2500 characters, then cut at last complete line
+ sed 's/^- /• /g')
+
+ # Truncate for Telegram 4096 char limit
CHANGELOG=$(echo "$CHANGELOG" | head -c 2500 | sed '$d')
-
- # Check if truncated
- FULL_LEN=${#FULL_CHANGELOG}
- if [ $FULL_LEN -gt 2500 ]; then
- CHANGELOG="${CHANGELOG}"$'\n\n... (see full changelog on GitHub)'
- fi
+ echo "$CHANGELOG" > /tmp/changelog.txt
fi
- echo "$CHANGELOG" > /tmp/changelog.txt
- echo "DEBUG: Final changelog:"
+ echo "Telegram changelog:"
cat /tmp/changelog.txt
- name: Send to Telegram Channel
diff --git a/.gitignore b/.gitignore
index e2e2649f..3c57112b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -12,6 +12,9 @@ Thumbs.db
# Kiro specs (development only)
.kiro/
+# Design assets (banners, mockups)
+design/
+
# Reference folder (development only)
referensi/
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 25d41bf0..ec8b7254 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,54 @@
# Changelog
+## [3.7.2] - 2026-03-07
+
+### Changed
+
+- **Amazon Music is now an Extension**: Amazon Music has been moved from a built-in service to a separate installable extension. Install the "Amazon Music" extension from the Store to continue using it.
+
+### Fixed
+
+- **Deezer Downloads Timing Out**: Deezer downloads were failing with "context deadline exceeded" on larger files. Now uses the proper download timeout, matching Tidal and Qobuz.
+- **iOS Local Library Scan Fails**: Local library scanning was failing on iOS because the app lost access to user-picked folders after the FilePicker session ended. Implemented iOS security-scoped bookmark system:
+ - When a library folder is picked on iOS, a security-scoped bookmark is created and persisted in settings (`localLibraryBookmark`)
+ - Before each scan, the bookmark is resolved and security-scoped access is started; access is released in `finally` block after scan completes
+ - `cleanupMissingFiles` also activates the bookmark before checking file existence on iOS
+ - New `AppDelegate.swift` method channel handlers: `createIosBookmarkFromPath`, `startAccessingIosBookmark`, `stopAccessingIosBookmark`, `resolveIosBookmark`
+ - New `PlatformBridge` methods: `createIosBookmarkFromPath()`, `startAccessingIosBookmark()`, `stopAccessingIosBookmark()`
+ - All scan call-sites (Library Settings, Queue tab, Local Album screen) now pass the iOS bookmark to `startScan()`
+
+### Added
+
+- **Amazon Music Extension**: Available in `extension/Amazon-SpotiFLAC/` — same functionality as before, now as an installable extension.
+- **Accessibility Tooltips**: Added localized tooltips to all `IconButton` and `PopupMenuButton` widgets across the entire UI for screen reader and long-press discoverability
+ - Back buttons use `MaterialLocalizations.backButtonTooltip`
+ - Close buttons use `MaterialLocalizations.closeButtonTooltip`
+ - Menu buttons use `MaterialLocalizations.showMenuTooltip`
+ - Search buttons use `MaterialLocalizations.searchFieldLabel`
+ - Contextual actions use descriptive labels: "Play track", "Dismiss", "Clear search", "Change folder", "Refresh"
+ - Screens affected: Album, Artist, Playlist, Downloaded Album, Local Album, Home, Search, Queue, Library Playlists, Library Tracks Folder, Setup, Tutorial, Track Metadata, Store, Extension Store Details, and all Settings sub-pages (About, Appearance, Cache Management, Donate, Download, Extensions, Extension Detail, Library, Log, Options, Provider Priority)
+- **Semantics Wrappers**: Added `Semantics` widgets to interactive elements that previously had no accessibility information
+ - Album tiles in Artist screen: announces selection state and album name
+ - Recently downloaded track tiles in Home tab: announces track name and artist
+ - Explore items (albums/artists/playlists) in Home tab: announces item type and name
+ - Color palette picker in Appearance settings: announces selected state and color hex value
+ - Download button demo in Tutorial screen: added `ExcludeSemantics` on icon to prevent duplicate screen reader announcements
+ - Queue tab playlist cards: announces playlist name and item count
+ - Queue tab downloaded album cards: announces album name, artist, and track count
+ - Queue tab local album cards: announces album name, artist, and track count
+ - Queue tab play button on completed downloads: announces track name and artist with `ExcludeSemantics` on icon
+ - Queue tab download status indicators: "Finalizing download", "Download completed", "Downloaded file missing" labels with `ExcludeSemantics` on icons
+
+### Improved
+
+- **Code Formatting**: Reformatted and corrected indentation across multiple files to comply with Dart style guidelines
+ - `extension_detail_page.dart`: Fixed `SliverAppBar` and all subsequent slivers indentation (was 2 spaces short)
+ - `log_screen.dart`: Fixed `SliverAppBar` indentation alignment
+ - `donate_page.dart`: Reformatted ternary expressions and `_cr` function body
+ - `library_tracks_folder_screen.dart`: Minor line-break formatting
+
+---
+
## [3.7.1] - 2026-03-06
### Added
diff --git a/README.md b/README.md
index 83669b33..c99cb71b 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,13 @@
-[](https://github.com/zarzet/SpotiFLAC-Mobile/releases)
-[](https://www.virustotal.com/gui/file/0a2bd2a033551983fc9fcd83f82fd912c83914fd1094cd8d1c7c6a68eb23233f)
-[](https://crowdin.com/project/spotiflac-mobile)
-
-
-
-Download music in true lossless FLAC from Tidal, Qobuz & Amazon Music — no account required.
-
-
-
+
+
+
+
+
-
-Download music in true lossless FLAC from Tidal, Qobuz & Amazon Music — no account required.
-
-
-
+
+