Skip to content

Audex 1.1.0

Choose a tag to compare

@MishaSok MishaSok released this 20 May 07:33

A major release with new music sources, a mobile mode, a multilingual interface, and a layout that adapts to narrow windows.

Download from the internet

  • YouTube — search and download tracks by query straight from the app (via yt-dlp, with automatic import into the library, cover art and tags).
  • Yandex Music — a playlist and album parser running on a bundled Chromium (Puppeteer). The login session persists between runs; a toggle controls whether the browser window is shown for sign-in / captcha.
  • Download queue with progress, pause and resume. Queue state and the tab position survive restarts.
  • Default folder — configurable in Settings; downloaded files land there, otherwise in ~/Music/Audex Downloads.

Mobile listening mode

  • A new portrait ("mobile player") layout for the fullscreen view; the window shrinks to 420×780.
  • Adaptive CSS — cover, titles and spacing scale from 420×780 up to a full screen.
  • If the app is in OS fullscreen, mobile mode no longer leaves fullscreen — the UI simply reflows into a centered mobile column.
  • The volume slider is now visible in both the desktop fullscreen view and the portrait view (larger and below the play/pause controls in portrait).

Interface

  • Languages: added a UI switcher — Russian, English, German, French, Ukrainian.
  • UI scale — a slider in Settings, applied instantly.
  • Contacts in Settings — links to the GitHub repository and Telegram (@JuicexNet) for bug reports and suggestions.
  • Animated now-playing transitions and a search-button animation (respecting prefers-reduced-motion).
  • Library sorting (dropdown) and removing tracks from a specific playlist.
  • Automatic rescan of the downloads folder and the default folder on startup.
  • Application icon (dark + light variants) for packaging.

Adaptive layout for narrow windows

  • At window widths ≤ 1100 px the sidebar shrinks, the "Album" column is hidden in tables, the playbar optimizes its layout, and the fullscreen player uses a smaller queue and cover.
  • Everything restores when the window is widened again.

System integration

  • MPRIS metadata and transport controls in the GNOME top bar (via navigator.mediaSession).
  • Mini-player navigation: click the cover → fullscreen; click the title/artist → jump to the library / artist page.
  • The last track is remembered across restarts.

Builds and platforms

  • Linux: AppImage and .deb (x64) — built locally, attached to this release.
  • macOS: arm64 .dmg and .zip — built by CI (GitHub Actions, macos-latest). The build is unsigned: on first launch use right-click → Open or xattr -d com.apple.quarantine /Applications/Audex.app.
  • Windows: NSIS installer (.exe) and .zip (x64) — built by CI (GitHub Actions, windows-latest). The build is unsigned: SmartScreen will warn → "More info → Run anyway".

Technical details

  • Chromium for the Yandex parser is bundled via Puppeteer (chromium-bundle/) and unpacked from the ASAR at runtime — no external dependencies for the user.
  • yt-dlp is a runtime dependency and is not bundled. If it is missing, the app reports: Install it: pip install -U yt-dlp.
  • Documentation on the release process and packaging pitfalls is in CLAUDE.md.