Muse is a personal project, inspired by Plex, that I crafted using htmx and PHP to deliver a seamless user experience.
- Scan and Manage Your Music: Use the included muse cli to scan your personal music collection, adding it to your centralized library.
- HD Radio: Introducing HD radio streaming! Now you can listen to high-quality radio stations directly within Muse. Simply select your favorite station and enjoy crystal-clear sound.
- Web-Based Music Player: Access and play your entire music library from anywhere through a user-friendly web interface.
- Podcasts with ListenNote: Explore a world of podcasts using the ListenNote integration.
- Built with htmx & PHP: Leverages the power of htmx for a responsive and dynamic user experience, with a robust PHP backend powered by your custom Nebula framework.
- Light/Dark Theme: Personalize your experience with light and dark theme options. Switch between themes effortlessly to match your environment and reduce eye strain during extended listening sessions.
- Custom User Playlists: Create and curate your own playlists. Organize your music by mood, genre, or any other criteria you like.
- Music enthusiasts who want a personal, cloud-accessible music library.
- Developers interested in exploring htmx and the Nebula framework.
- Clone the repository:
git clone https://github.com/whleucka/muse.git
- Follow the setup instructions in the README for dependencies and configuration WIP
-
Install composer dependencies
composer install
-
Copy the example .env and update your database credentials
cp .env.example .env
-
Generate a secure application key, add this to your .env under APP_KEY
./bin/console generate-key
-
Run the database migrations
./bin/console migrate-fresh
-
Run the muse cli to scan your music collection. This could take a while, depending on how many files require id3 tag analysis.
./bin/console music-scan /path/to/music
-
Create a storage directory and give the proper permissions. Create a sym link in the public directory
mkdir ./storage chown -R www-data:www-data storage cd public && ln -s ../storage
-
Access your music library, podcasts, or HD radio through the web interface!
-
We welcome contributions to Muse! Feel free to fork the repository and submit pull requests.