Repository files navigation

Beetiful is a simple yet elegant web-based interface for managing your music library usingbeets. 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/vansmakThank you for your support!

• Command Builder for running Beets commands
• Config Editor to edit thebeets configuration 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:

1. Clone the Repository

   git clone https://github.com/Vansmak/beetiful.gitcd beetiful

2. Create a Virtual Environment

   It's recommended to use a Python virtual environment to keep your dependencies isolated.

   python3 -m venv venvsource venv/bin/activate

3. Install Dependencies

   Install the required Python packages:

   pip install -r requirements.txt

4. Environment Variables

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 directoryBEETSDIR=/.config/beets# Path to your music libraryLIBRARY_PATH=/music# Add any other environment-specific settings herePORT=```

5. **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 likeimport,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. Thesave button will update theconfig.yaml file.