Beetiful is a simple yet elegant web-based interface for managing your music library using beets. It allows you to manage and interact with your music library through an intuitive GUI, while leveraging the power of beets on the backend.
If you find this project helpful, please consider supporting it. Your contributions help maintain and improve the project. Any support is greatly appreciated! ❤️ https://buymeacoffee.com/vansmak Thank you for your support!
- Command Builder for running Beets commands
- Config Editor to edit the
beetsconfiguration file directly from the interface - Music Library Viewer with filtering, sorting, and pagination
- Simple integration with beets' advanced music management features
- Docker
- Plugin manager
- More commands
- Mobile friendly layout
To install Beetiful, follow these steps:
-
Clone the Repository
git clone https://github.com/Vansmak/beetiful.git cd beetiful -
Create a Virtual Environment
It's recommended to use a Python virtual environment to keep your dependencies isolated.
python3 -m venv venv source venv/bin/activate -
Install Dependencies
Install the required Python packages:
pip install -r requirements.txt
Create a .env file in the project root to configure Beets-specific settings. Here's an example:
```
# .env file
# Path to the user's Beets configuration directory
BEETSDIR=/.config/beets
# Path to your music library
LIBRARY_PATH=/music
# Add any other environment-specific settings here
PORT=
```
- **Running the Application
To start the application, you can run the following command from the project root:
python app.py
Open your browser and navigate to `http://127.0.0.1:3001`.
- Command Builder: Execute standard Beets commands like
import,list,update,modify, and more. Build commands interactively through the UI. - Library Management: View your library with sorting and filtering options. Use the pagination buttons to navigate large libraries.
- Config Editor: Edit the Beets configuration directly from the web interface. The
savebutton will update theconfig.yamlfile.
