Changelog
Windows builds: free code signing provided by SignPath.io, certificate by SignPath Foundation (code signing policy).
FYI:
Lokal is 100% local; the library, history, anything in database, or any info that is used for API's such as yt-dlp, LRCLIB, is NOT seen by us.
What's Changed
-
Yandex implementation (#423)
Details
User description
Summary
- Add a SpotiFLAC-compatible Yandex Music download provider for Lokal.
- Support track, album, and artist search, album/artist browsing, and Yandex Music track/album/artist URLs.
- Add an encrypted OAuth-token setting and lossless/high quality choices.
- Request Yandex
get-file-info, download available FLAC/AAC/MP3 formats, and decrypt AES-CTR audio in bounded chunks. - Include an installable
.sflxarchive and MIT license attribution for the API/signing/decryption flow adapted fromllistochek/yandex-music-downloader. - Add offline regression tests to
npm run test:ported.
Installable package
Direct archive URL (while this PR branch exists):
https://raw.githubusercontent.com/CHEYCKIT/lokal/feat/yandex-music-spotiflac-package/addons/yandex-music.sflxAfter installing, open Settings → Addons → Yandex Music and enter your own Yandex Music OAuth token. Access to a track and its quality remains dependent on Yandex's availability, region, and account/subscription rules.
Testing
Added
scripts/yandex-music-package.test.mjsfor search normalization, album/artist filters, file-info signing/transfer, and missing-token behavior. CI status is not yet verified; the package has not been tested against a live Yandex account from this environment.
CodeAnt-AI Description
Add Yandex Music search and downloads to Lokal
What Changed
- Search Yandex Music for tracks, albums, and artists, and open album and artist pages or Yandex Music links.
- Download tracks using your own OAuth token, with lossless FLAC when available and AAC or MP3 alternatives.
- Show actionable messages when a token is missing or Yandex denies access.
Impact
✅ Browse Yandex Music tracks, albums, and artists
✅ Download available FLAC, AAC, or MP3 audio
✅ Clearer token and access errors💡 Usage Guide
Checking Your Pull Request
Every time you make a pull request, our system automatically looks through it. We check for security issues, mistakes in how you're setting up your infrastructure, and common code problems. We do this to make sure your changes are solid and won't cause any trouble later.
Talking to CodeAnt AI
Got a question or need a hand with something in your pull request? You can easily get in touch with CodeAnt AI right here. Just type the following in a comment on your pull request, and replace "Your question here" with whatever you want to ask:
@codeant-ai ask: Your question hereThis lets you have a chat with CodeAnt AI about your pull request, making it easier to understand and improve your code.
Example
@codeant-ai ask: Can you suggest a safer alternative to storing this secret?Preserve Org Learnings with CodeAnt
You can record team preferences so CodeAnt AI applies them in future reviews. Reply directly to the specific CodeAnt AI suggestion (in the same thread) and replace "Your feedback here" with your input:
@codeant-ai: Your feedback hereThis helps CodeAnt AI learn and adapt to your team's coding style and standards.
Example
@codeant-ai: Do not flag unused imports.Retrigger review
Ask CodeAnt AI to review the PR again, by typing:
@codeant-ai: reviewCheck Your Repository Health
To analyze the health of your code repository, visit our dashboard at https://app.codeant.ai. This tool helps you identify potential issues and areas for improvement in your codebase, ensuring your repository maintains high standards of code health.
Summary by CodeRabbit
- New Features
- Added a Yandex Music provider for searching tracks, albums, and artists, and opening supported Yandex Music links.
- Download tracks in supported audio formats, with lossless quality available when requested.
- Configure access with a Yandex Music OAuth token.
- Documentation
- Added setup instructions and details about supported searches, links, download formats, and licensing.
Contributors: @CHEYCKIT
Full Changelog: v9.1.5...v9.1.6
Setup
See README.md for full setup instructions.
macOS: this build is ad-hoc signed, not notarized (no Developer ID certificate is configured). The first time, right-click Lokal in Applications and choose Open, or run xattr -dr com.apple.quarantine /Applications/Lokal.app.
Binary Checksums (SHA-256)
Lokal-9.1.6-arm64-mac.zip:
[0E39046A80A4EE28C9CD973AA536691FFDBEE6B1D307C4B764319A06B1144B9F]
Lokal-9.1.6-arm64-mac.zip.blockmap:[B2C9A16D49B8E66B7E83C65FDC258318FFF742A0D5E9ABA4A2A9E17A592A3778]
Lokal-9.1.6-arm64.AppImage:[5CC2E37BE1486EE334632D73662018258B7AA4E652C8C419CF9583446ADB1C50]
Lokal-9.1.6-arm64.dmg:[481D59DE4E7A0DEADA2CB89275CDA1BE79854A84C649EE2045A4F46CDF777121]
Lokal-9.1.6-arm64.dmg.blockmap:[2ADB820AF5D0965A836F278D3EDEDA913526C37CBBDF6C7FC0E24E014F32EB7B]
Lokal-9.1.6-mac.zip:[54F851D5DE8128D12805B7D91A56F84C4945800BBE81D7D67C7555345A891D7D]
Lokal-9.1.6-mac.zip.blockmap:[87794D9DE55822A96A8D610050A4B5B617C821F0D76BE28DBCF4865923DB89E9]
Lokal-9.1.6.AppImage:[9497A680A1F38BDFD4D31BE53B4BA09EB6650F85B4A64A132458D790B78EAD1E]
Lokal-9.1.6.dmg:[B993A08100F758656F03A287569CB50682CFBD337CD3DC71F4220FBA8F0DD7FE]
Lokal-9.1.6.dmg.blockmap:[B14C12B68D1F6D990BBC052553F623FDBE5661F2E993329D60BF54BB3AE67FC4]
Lokal-9.1.6.exe:[411E94DF5FCA7908CA3F5EA5EB0A25CA1153347A51767CC0602E99D0FC0E487B]
Lokal-Setup-9.1.6.exe:[ED0756B9E40E524A3221B355082EBC13ABD209C864C1B5C2DF595929D42AFFA6]
Lokal-Setup-9.1.6.exe.blockmap:[C4C9D144B2BE3CEC0EBAE566D11BCC8E8458D1F4956805FCAE3497E79B7161BF]
builder-debug.yml:[0BEBFBBC03C22F47DC21949BCE24A936251BF04CB9F2A6F0671AEDCC6402C57F]
latest-linux-arm64.yml:[566249225340F1E6C2448F01D0352419F5597F3CDEB76D94648A547217FA17A3]
latest-linux.yml:[C4F398E17FB2BBB318004BAB902718E55A69A4EA7240153DC0EA852F3BBEA5BB]
latest-mac.yml:[2633BAEB5569B4D6ED1A4F8A24A6D053C0144B6EAC96D3F6DD1611F2DF0967FD]
latest.yml:[284CF4EA0A0C743BA431F72118671CDDEF0A643D1825DD896025C41DC2989179]
lokal-music_9.1.6_amd64.deb:[77724C411A966F467DF6624F2CD0553D2B815304EAC224A1E602FF68E8D05391]
lokal-music_9.1.6_arm64.deb:[B94D7954AB54E3436D2A04FF53C68FB1677C7AC123B2F1E46C6CD09974E7C6A3]
