Beni-BandcampPlayer

KO | EN

gitlite — search

#hacktoberfest #markdown #terminal #nextjs #gemini #reactjs #android #http #pdf #video

Beni-BandcampPlayer

(★ 9)

Compact, Fully featured Bandcamp Streaming App for Windows 10/11.

파일 탐색기

ZIP 다운로드

- continuous.png
- download-button.png
- download.png
- icon-title (new).png
- icon-title.png
- Image viewer button.png
- image-viewer-v2.0.0.png
- main-v1.0.0.png
- main-v2.0.0.png
- OGBandcampPlayer.png
- Playback modes.png
- player modes.png
- repeat album.png
- repeat track.png
- repeat-1.png
- repeat-album.png
- shuffle albums.png
- shuffle tracks and albums.png
- shuffle-album.png
- shuffle-repeat.png
- shuffle-tracks.png
- super-shuffle.png
- support_me_on_kofi_beige.png
- vis-menu.png
launcher_manifest.json
launcher_manifest_dev.json
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

### A lightweight Bandcamp Player for Windows 10/11.

### Fast, focused, and built for listening.
<br>
</div>
<div align="center">

[Key Features](#key-features) &nbsp;&middot;&nbsp; [Quick Start](#quick-start) &nbsp;&middot;&nbsp; [Troubleshooting](#troubleshooting) &nbsp;&middot;&nbsp; [Credits](#credits--inspiration) &nbsp;&middot;&nbsp; [Disclaimer](#legal-information)
</div>

>**Note:** This app streams Bandcamp's official 128 kbps preview streams, and Bandcamp's standard listening limits may apply. Support the artists you love to get unlimited access to full-quality downloads for your favourite music player, such as MusicBee, foobar2000, or VLC.

<br>

*The main player regular/mini/micro/nano modes and notification.*

*The image viewer mode with player, playlist, visualizer and particles effects available.*

## Key Features

* **Minimal design** - that stays out of your way with 3 modes to suit your style:
  * **Regular Mode** - main window that can be rolled up into Mini or Micro modes to save screen space.
  * **Nano Mode** - An ultra-compact, auto-hiding player inspired by classic desktop music apps like Winamp.
  * **Image Viewer Mode** - a lightbox-style showcase (great if you have a second monitor). Zoom and pan artwork, go fullscreen, and enjoy visual effects.  
* **Volume Control** - Adjustable volume controls.
* **Info Popups** - Use the info buttons next to albums and tracks to view Album, artist, track, and supporter information directly from the player.
* **Playlist Management** - Easily create and manage URLs and Save/Load separate lists.

* **Search and Filters** - Quickly search and filter your current session and saved playlists.

* **Import URLs** - Easily import artist discographies, similar artists, and Bandcamp collections.
* **Linked Collections** - Create linked collections and wishlists that can be easily synced with Bandcamp.

* **Shuffle & Repeat** - Multiple playback modes for varied listening.
* **App Themes** - Choose from Light, Dark, Album or Custom!
  * **Album Themes** - Automatically extract colour palettes from each URL for a unique look that matches the artist's intent. Palettes can be saved and edited - with a _Prefer Saved_ option to use your own custom palettes when available. 
* **Custom Themes** - Save an album theme you like or create your own with built-in Theme editor!

<div align="center"><img width="583" alt="Album Themes" src="https://github.com/user-attachments/assets/0a8959b6-0bc9-4ca0-b5f4-78ec3f8e13f9" /></div>
 
* **Account Menu** - Login to Bandcamp securely to enable **Follow Artist** and **Wishlist Album** features directly from the Apps Fan Account Menu and unlock unlimited streaming of albums you've purchased with a fancy icon and thank you messages. 
* **Track Change Notifications** - Keep track of what you are listening to, especially helpful in Nano Mode when autohidden; adjust the notifications or turn them off in the settings. 
* **Keyboard Shortcuts** - Full keyboard control for play, pause, next, previous, volume, and more (customizable in the settings menu). With Global Support.

## Quick Start

**Installation**

Download and run the [Latest Installer](https://github.com/bshurikan/Beni-BandcampPlayer/releases) to install the app, then use the desktop or start menu shortcut to start it.

**Note:** You may see a Windows Defender SmartScreen Warning, see [Troubleshooting](#troubleshooting) for more information.

## Usage

**Video Overview**

1. **Add URLs**: Drag and drop Bandcamp URLs into the main window (to load it right away) or into the playlist to create a queue (CTRL+V, Right click and select Paste URL also work).
3. **Play Music**: Double click on an album in the playlist to load the url and start playing.
4. **Player Controls**: Use the Play controls or keyboard shortcuts to navigate albums and tracks, and adjust play modes (see [Shuffle & Repeat Modes](#shuffle--repeat-modes--)).
6. **Album List**: Use the Album List to manage Bandcamp URL's, you can add/remove, reorder, load artist discography or similar artists, save and load Album lists and more. The Album List can act as a sidebar (attached to the main window) or be detached for more flexibility (the detached Album List can be resized, docked to the main window and will remember its state/position)
7. **Window Modes**: Roll up the main window into **Mini** or **Micro** using the upward chevron or minimize to the separate **Nano Player** from the title bar.
8. **Image Viewer**: Click on the fullscreen button to enter **Image viewer**, a lightbox style viewer.
10. **Settings Menu**: Click on the cog icon to reach additional options like Updates, Settings, Themes, and more.

## Image Viewer (Fullscreen Cover Art with player)

**Image Viewer Options:** toggle player autohide, visualizations*, particle effects and more.

***Visualizations are simulated:** this app exclusively streams music via Bandcamp's embedded player, which does not provide safe, reliable access to the live audio data required for real-time spectrum analysis or waveforms. Instead, visualizations use playback-aware animation.

For true audio-reactive visualizations, please support the artist by purchasing and downloading the music from Bandcamp and playing it in a dedicated offline music player such as MusicBee, foobar2000, or VLC.

## Shuffle & Repeat Modes  <img alt="shuffle-repeat" src="images/shuffle-repeat.png" />

- <img alt="shuffle-tracks" src="images/shuffle-tracks.png" width="25" /> **Shuffle Tracks** – shuffle tracks within current album
- <img alt="shuffle-album" src="images/shuffle albums.png" width="25" /> **Shuffle Albums** – play albums in random order
- <img alt="shuffle-tracks+albums" src="images/shuffle tracks and albums.png" width="25" /> **Shuffle Tracks + Albums** – play random albums and shuffle tracks
- <img alt="super-shuffle" src="images/super-shuffle.png" width="25" /> **Super Shuffle** – completely random album and track; avoids repeats
- <img alt="repeat-1" src="images/repeat track.png" width="25" /> **Repeat Track** – loop current track
- <img alt="repeat-album" src="images/repeat album.png" width="25" /> **Repeat Album** – loop current album
- <img alt="continuous" src="images/continuous.png" width="25" /> **Repeat All** – loop entire queue

**Combinations:** Repeat modes options will override Shuffle modes (e.g., *Repeat Track* supercedes all modes, *Repeat Album* downgrades *Super Shuffle* to *Regular Shuffle*, etc.).

## Keyboard Shortcuts

* **Play/Pause** - Ctrl + Alt + Space
* **Next Track** - Ctrl + Alt + Right
* **Previous Track** - Ctrl + Alt + Left
* **Next Album** - Ctrl + Shift + Alt + Right
* **Previous Album** - Ctrl + Shift + Alt + Left
* **Volume Up** - Ctrl + Shift + Up
* **Volume Down** - Ctrl + Shift + Down
* **Mute** - Ctrl + Shift + M
* **Toggle Playlist** - Ctrl + Alt + P
* **Expand/Collapse Playlist** - Ctrl + Shift + Alt + P
* **Cycle App Mode** - Ctrl + Alt + M
* And more... (see Settings > Keyboard Shortcuts)

## Technology & Approach

Bandcamp doesn’t currently provide a public API for music playback, playlists, or track data (its official APIs are limited to sales and merchandise for artists and labels).

Without a public playback API, Beni's Bandcamp Player instead relies on Bandcamp's native web pages, loading them in an embedded Chromium-based browser and providing a custom interface with added features such as enhanced playback controls, playlists, window modes, keyboard shortcuts, and more.

**Note:** Because the app loads the live Bandcamp website, account features like purchasing, wishlisting, and login work natively, and Bandcamp's standard listening limits apply.

### Core Stack

- **PySide6** – Cross-platform desktop framework for window management
- **PyQt6-WebEngine** – Embedded Chromium browser used to load Bandcamp’s site with full DOM access
- **Qt-Painted Interface** - Fully customizable Qt interface used for reliability and extensibility
- **QtAwesome** – FontAwesome icons for consistency across platforms

## Troubleshooting

**1. Please Note:**
- Documentation is still improving
- This app has received a considerable amount of testing so it should be pretty stable but you may still encounter bugs, please feel free to report any issues or suggestions. 
- Issues can usually be resolved by loading another url, restarting the app, or if you're really stuck: close the app and rename or delete <code>settings.json</code> and delete the <code>\Backups</code> and <code>\webengine_storage</code> folders.

**2. Windows SmartScreen Warning:**

- When you open the app for the first time, Windows might say: "Windows protected your PC"
- This happens because the app isn't code-signed. Code-signing certificates can be expensive for independently developed freeware applications.
- **To continue:** Click "More info" and "Run anyway", Windows won't nag you again for the same .exe.

**3. Player not responding or sluggish:**
- This App requires a high speed internet connection.
- Verify the Bandcamp URL is valid and accessible (sometimes artists remove access to an album or redirect it), check the album page to make sure its still there, remove the url and readd it. 
- Try refreshing the URL or switching to another URL. 
- VPNs, proxies, or ISP “secure connection” features can block or slow the CDN requests used to fetch artwork and metadata. Try turning these off or switching to a faster VPN location or Split tunnel and exclude the app. 
- Antivirus software with HTTPS/SSL scanning (Kaspersky, ESET, Dr.Web, etc.) may interfere with image requests — temporarily disable these features to test. If it helps, whitelist the app and bandcamp.com.
- Bad DNS routing can also cause slow or missing images. Switching to 1.1.1.1, 8.8.8.8, or 9.9.9.9 may help.

**4. Playlist not saving:**
- Check that the Playlists folder exists in the app directory
- Verify write permissions for the app directory

## Credits & Inspiration

**A Note on the Name**<br>

Beni's Bandcamp Player is named in memory of my mom, Beni, who passed away on December 24, 2025. ♥

**Evolution of the App**<br>

This project was originally inspired by Robert Golderbine's [Companion Window | Always on Top](https://chromewebstore.google.com/detail/companion-window-always-o/hhneckfekhpegclkfhefepcjmcnmnpae) and Yuki Eliot's [Mobile View Switcher](https://chromewebstore.google.com/detail/mobile-view-switcher/ddfcjnekgmblacbpifjdmcbbhfcdekic).

Prior to this project I was using a **customized version of Companion Window** in combination with **Mobile View Switcher** as a Mini BandCamp Player (It featured a compact bandcamp mode that stripped away everything but the player and playlist, and had a roll up feature like the current app - but had to be launched separately for each album url and had many security limitations inherent in browser PIP implementations preventing automations e.g. automatic resizing, playback manipulation, playlists+ which are now made possible in the latest version.

_Original Bandcamp Player browser extension_

Out of interest here is a screenshot from an early prototype of the current player that displayed the mobile webview directly instead of using a custom interface (an evolution of the original browser extension concept). However it also had a number of limitations and bugs that were difficult to surmount (the live webview could be unpredictable and fail to reliably inject css and js) *The live webview is still presented in the current app when logging in or out and fundamental to the app behind the scenes.

_Early V1 Prototype that presented the bandcamp mobile webview directly_

## Legal Information

Beni's Bandcamp Player is free proprietary software distributed as compiled releases only. Source code is not publicly distributed. GitHub is used for releases, issue tracking, and documentation. For complete terms, see the included EULA.txt.

Beni's Bandcamp Player is independent third-party software and is not affiliated with, endorsed by, or sponsored by Bandcamp. All Bandcamp trademarks, content, and services remain the property of their respective owners.

The application streams music through Bandcamp's official web player for personal listening and music discovery. Please respect copyright laws, Bandcamp's terms of service, and support the artists you enjoy by purchasing their music whenever possible.

This software is provided free of charge, as-is. Because the app relies on Bandcamp's live website, future changes to Bandcamp's service may temporarily affect functionality, and ongoing compatibility cannot be guaranteed.

Beni-BandcampPlayer

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README