ivan/foldio-desktop
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
12 commits 1 branch 0 tags 88 KiB
  • C++ 98.2%
  • CMake 1.8%
Find a file
Exact
ika 8098520218 Add README 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-31 10:42:39 +02:00
src Wrap playlist name text and use minimum height for items 2026-03-31 10:26:34 +02:00
.gitignore init 2026-03-27 14:27:13 +01:00
CLAUDE.md Add CLAUDE.md with build instructions and architecture overview 2026-03-27 14:09:30 +01:00
CMakeLists.txt Add album art picker with configurable thumbnail count 2026-03-27 21:20:37 +01:00
LICENSE Add BSD 3-Clause License (Ivan Kanis 2026) 2026-03-31 10:40:57 +02:00
plan.md Responsive 2×3-column grid layout with 2×2 art grid and configurable thumbs 2026-03-31 10:15:25 +02:00
README.md Add README 2026-03-31 10:42:39 +02:00

README.md

Foldio

A Qt6/C++ desktop music player for Linux. MP3 files are organised into playlists by directory — each subdirectory of a configured root becomes a playlist.

Features

  • Playlist view with 2×2 album art grid per entry (or single icon mode)
  • Responsive 2/3-column layout that adapts to window width
  • Shuffle playback across one or multiple selected playlists
  • Clickable album art thumbnails to pick custom artwork per slot
  • MPRIS2 D-Bus interface for media keys and desktop integration
  • Configurable thumbnail size and display mode

Dependencies

  • Qt6 (Widgets, Multimedia, DBus)
  • TagLib
  • CMake 3.16+

On Debian/Ubuntu:

apt install qt6-base-dev qt6-multimedia-dev libtag1-dev cmake

Build

cmake -B build
cmake --build build

The binary is output to build/foldio.

Usage

  1. Launch foldio
  2. Open Settings and select a root directory whose subdirectories are your playlists
  3. Click a playlist row to play it, or check multiple playlists and press Play Selected
  4. Click any album art thumbnail to replace it with artwork from another track in that playlist

License

BSD 3-Clause — see LICENSE.