Bare Bones V2

Now updated with:

• main player window
• CustomTkinter-based playlist UI
• borderless minimal/music mode
• borderless always-on-top PiP window with hover controls
• VLC playback backend that rebinds the video surface without intentionally resetting playback
• optional YouTube resolving via yt-dlp
• best-effort embedded album art extraction via mutagen

Install

pip install -r requirements.txt

You also need desktop VLC installed so python-vlc can find the VLC runtime.

Run

python main.py

Notes

• The UI is fully CustomTkinter-based for the app windows.
• Video output is embedded through VLC into a Tk/CTk frame using the frame's native window handle.
• PiP and minimal mode switch by rebinding the VLC target widget instead of intentionally stopping playback.
• Album art is best-effort. Embedded art is supported for common audio formats when available.
• YouTube playback uses yt-dlp if installed. If a URL cannot be resolved, the app falls back to trying the URL directly.

Project layout

• main.py – entrypoint
• app/player_backend.py – VLC wrapper
• app/windows/main_window.py – primary app window
• app/windows/minimal_window.py – compact music mode window
• app/windows/pip_window.py – hover-control PiP window
• app/widgets/playlist_panel.py – CustomTkinter playlist view
• app/widgets/transport_bar.py – transport controls
• app/widgets/youtube_tab.py – YouTube queue/play tab
• app/utils/artwork.py – embedded artwork extraction
• app/utils/youtube.py – yt-dlp resolve helper