![Musare](frontend/dist/assets/blue_wordmark.png)

# Musare

Musare is an open-source collaborative music listening and catalogue curation application. Currently supporting YouTube based content.

The master branch is available at [musare.com](https://musare.com).

You can also find the staging branch at [musare.dev](https://musare.dev).

---

## Documentation
- [Installation](./.wiki/Installation.md)
- [Configuration](./.wiki/Configuration.md)
- [Utility Script](./.wiki/Utility_Script.md)
- [Technical Overview](./.wiki/Technical_Overview.md)
- [Backend Commands](./.wiki/Backend_Commands.md)
- [User Guide](./.wiki/User_Guide.md)
- [Contributing](./.wiki/Contributing.md)

---

## Features
- Playlists
    - User created playlists
    - Automatically generated playlists for genres
    - Privacy configuration
    - Liked and Disliked songs playlists per user
    - Bulk import songs from YouTube playlist
    - Add songs from verified catalogue or YouTube
    - Ability to download in JSON format
- Stations
    - Playlist mode to listen to selected playlists
    - Party mode to allow other users to add songs to queue
    - Ability to blacklist playlists to prevent songs within from playing
    - Themes
    - Privacy configuration
    - Favoriting
    - Official stations controlled by admins (playlist mode only)
    - User created and controlled stations
    - Pause playback just in local session
    - Station-wide pausing by admins or owners
    - Vote to skip songs
    - Force skipping song by admins or owners
    - Add songs to queue from verified catalogue or YouTube (party mode only)
- Song Management
    - Verify songs to allow them to be searched for and played in official stations
    - Hide songs to remove from unverified catalogue
    - Import Album (WIP) to import songs in bulk
    - Discogs integration to import metadata
    - Ability for users to report issues with songs and admins to resolve
    - Configurable skip duration and song duration to cut intros and outros
    - Request songs from YouTube in official stations or admin area
    - Any song added to playlists or stations will be automatically requested
- Users
    - Activity logs
    - Profile page showing public playlists and activity logs
    - Text or gravatar profile pictures
    - Email or Github login/registration
    - Preferences to tailor site usage
    - Password reset
    - ActivityWatch integration
- Punishments
    - Ban users
    - Ban IPs
- News
    - Admins can add/edit/remove news items
    - Markdown editor

---

## Contact

Get in touch with us via email at [core@musare.com](mailto:core@musare.com).