v2026.8.5.0

Tidekeeper 2026.8.5.0

v2026.8.4.0

Merge pull request #47 from OpenNerdz/release/2026.8.4.0

Release 2026.8.4.0

Tidekeeper 2026.7.30.0

Tidekeeper 2026.7.30.0

Maintained Tidal-Media-Downloader fork with terminal and desktop GUI workflows.

Install (PyPI)

python -m pip install -U tidekeeper
tidekeeper --help

GUI:

python -m pip install -U "tidekeeper[gui]"
tidekeeper-gui

Package page: https://pypi.org/project/tidekeeper/

Prebuilt binaries

Assets below include terminal and GUI executables for Windows, macOS, and Linux.

ffmpeg is recommended for video downloads and optional FLAC remux (tidekeeper --doctor reports availability). The Docker image bundles ffmpeg — see the README for container usage.

2026.7.30.0 - 2026-07-30

Reliability and correctness

• Fixed -l/--link downloads so the CLI exits when finished instead of dropping into the interactive menu (#39, thanks @redraven2459).
• CLI -l/--link exits with a non-zero status when downloads fail.
• Fixed --doctor, --gui, module execution, and standalone builds returning success after operational failures.
• Invalid config paths and updater launch failures now produce clean errors instead of tracebacks.
• GUI now reports failed queue items as Failed instead of Done when downloads return errors.
• Lookup errors (401/403/network) are no longer masked as "No result." while probing media types.
• Reduced HTTP 429 rate-limit errors by pacing playback manifest requests and caching duplicate stream manifest lookups.
• Shortened stream-manifest cache TTL so expired CDN URLs are less likely to be reused.

Metadata and path tokens

• Fixed album artist metadata conversion so album artist lists and {ArtistName}/{ArtistID} album tokens are populated correctly (#38, #41).
• Fixed track/album tagging and path building when TIDAL omits the artist list, which previously raised 'NoneType' object is not iterable (follow-up to #38).
• Hardened path tokens, artist lists, and empty search results against missing/null API fields.
• Fixed {ArtistID}/{AlbumArtistID} album path tokens writing literal None when TIDAL omits an artist ID; those artists are now skipped.
• Fixed {AlbumArtistID} and {AlbumArtistName} rendering literal None when primary artist fields are absent.
• Added the {AlbumArtistID} album path token (#36, thanks @redraven2459).
• Added a --configPathOverride CLI argument for custom config locations (#37, thanks @redraven2459).

Packaging, Docker, and release tooling

• Added a release workflow that builds the sdist and wheel and publishes to PyPI with trusted publishing.
• Added a Dockerfile that bundles ffmpeg and keeps config, tokens, and logs in /config with downloads in /downloads.
• Added Python 3.14 to the CI matrix and a packaging job that verifies the PyPI long description survives the sdist round trip.
• Fixed the local build script deleting packaging metadata and omitting the GUI executable.
• Aligned runtime dependency pins between setup.py and requirements.txt.
• Added a high-signal Ruff lint gate in CI (syntax and undefined-name defects).
• Documented container usage, ffmpeg recommendation, and the complete GitHub/PyPI release checklist.

Contributor experience

• Fixed the test suite reading and overwriting the real ~/.tidal-dl.json profile, which caused false rate-limit test failures for contributors.
• Exposed adaptive rate-limit toggle in GUI settings layout and CLI settings.
• Replaced deprecated PrettyTable PLAIN_COLUMNS usage with TableStyle.

Tidekeeper 2026.7.11.0

Highlights

• Improved lossless and hi-res fallback behavior, request pacing, and HTTP 403/429 handling.
• Added {ArtistID} support for album folder formats.
• Updated dependencies, GitHub Actions, and Python 3.10–3.13 support.
• Improved Termux installation guidance and maintenance tooling.
• Expanded regression coverage to 109 tests and streamlined documentation.

Downloads

Standalone terminal and GUI builds are available below for Linux, macOS, and Windows.

Tidekeeper 2026.6.2.0

Highlights

• Fixed the desktop GUI on Windows 11 dark mode — menus, search results, and settings should no longer look blank or all white.
• Optional Save FLAC as .flac files setting (turn on in Settings; needs ffmpeg for conversion).
• Configurable request interval if TIDAL slows your downloads down (Settings → Use request delay → Request interval).
• Better handling when a track is "not ready yet," with automatic retries and clearer error messages.
• Video-only artist downloads, improved download reliability, GUI polish, and in-app update actions.

Downloads

• tidekeeper-Windows.exe / tidekeeper-gui-Windows.exe
• tidekeeper-Linux / tidekeeper-gui-Linux
• tidekeeper-macOS / tidekeeper-gui-macOS

Tidekeeper 2026.5.23.0

Highlights

• Added a modern PySide6 desktop GUI with parity for terminal auth, search, queue, direct downloads, settings, client selection, manual token login, and doctor diagnostics.
• Added automated GUI screenshot smoke testing with dense demo data.
• Added cross-platform release builds for both tidekeeper and tidekeeper-gui on Windows, Linux, and macOS.
• Preserved a lightweight terminal executable by keeping the GUI import lazy and shipping the GUI as its own binary.

Release assets

• tidekeeper-Windows.exe
• tidekeeper-gui-Windows.exe
• tidekeeper-Linux
• tidekeeper-gui-Linux
• tidekeeper-macOS
• tidekeeper-gui-macOS

Tidekeeper CLI 2026.5.17.4

Tidekeeper CLI 2026.5.17.4

Highlights

• Adds SECURITY.md, CONTRIBUTING.md, and CHANGELOG.md for clearer project maintenance.
• Links the new project docs from the README.
• Restricts local token file permissions to owner-only on POSIX systems.
• Improves parsing for TIDAL share URLs with query strings, fragments, and nested paths.
• Adds regression coverage for URL parsing and token file permissions.

Verification

• Tag CI passed for Python 3.10, 3.11, 3.12, and 3.13.
• Release binaries were rebuilt by GitHub Actions for Linux x64, macOS arm64, and Windows x64.

Tidekeeper CLI 2026.5.17.3

Tidekeeper CLI 2026.5.17.3

Highlights

• Adds Dolby Atmos stream support and identifies Atmos downloads in filenames.
• Logs failed track downloads to failed-tracks.txt for easier retry.
• Improves Termux install and first-run behavior.
• Adds the one-command Linux/Termux installer.
• Fixes the lyrics endpoint and hardens CLI auth/path handling.
• Refreshes README branding and repository maintenance cleanup.

Verification

• Tag CI passed for Python 3.10, 3.11, 3.12, and 3.13.
• Release binaries were rebuilt by GitHub Actions for Linux x64, macOS arm64, and Windows x64.

Tidekeeper CLI 2026.5.16.7

Tidekeeper CLI 2026.5.16.7

First maintained Tidekeeper CLI release.

Highlights

• Updated for the current TIDAL login flow.
• Restored working CLI downloads for current TIDAL tracks.
• Fixed DASH audio output so downloaded files are saved with the correct container extension.
• Added a simpler interactive home screen.
• Added clear / cls to redraw the startup options.
• Added automated executable builds for Linux, Windows, and macOS.

Downloads

• tidekeeper-linux-x64 for Linux
• tidekeeper-windows-x64.exe for Windows
• tidekeeper-macos-arm64 for Apple Silicon macOS runners
• SHA256SUMS.txt for checksum verification

This is a maintained community fork and is not affiliated with the original upstream maintainer.