# Musare
Musare is an open-source collaborative music listening and catalogue curation
application. Currently supporting YouTube based content.
A production demonstration instance of Musare can be found at [demo.musare.com](https://demo.musare.com).
---
## Documentation
- [Installation](./.wiki/Installation.md)
- [Upgrading](./.wiki/Upgrading.md)
- [Configuration](./.wiki/Configuration.md)
- [Utility Script](./.wiki/Utility_Script.md)
- [Backend Commands](./.wiki/Backend_Commands.md)
- [Technical Overview](./.wiki/Technical_Overview.md)
- [Value Formats](./.wiki/Value_Formats.md)
---
## Features
- **Playlists**
- User and admin created playlists
- Automatically generated playlists for genres
- Privacy configuration
- Liked and Disliked songs playlists per user
- Bulk import videos from YouTube playlist
- Add songs from verified catalogue or YouTube videos
- Ability to download in JSON format
- **Stations**
- DJs - Allow other users to manage the station queue
- Requests - Toggleable module to allow users to add songs to the queue
- Configurable access level and per user request limit
- Automatically request songs from selected playlists
- Ability to search for songs from verified catalogue or YouTube videos
- Autofill - Toggleable module to allow owners or DJs to configure automatic
filling of the queue from selected playlists
- Configurable song limit
- Play mode option to randomly play many playlists, or sequentially play one
playlist
- Ability to search for playlists on Musare
- Ability to blacklist playlists to prevent songs within from playing
- Themes
- Privacy configuration
- Favoriting
- Official stations controlled by admins
- User created and controlled stations
- Pause playback just in local session
- Station-wide pausing by admins, owners or DJs
- Vote to skip songs
- Force skipping song by admins, owners or DJs
- **Song Management**
- Verify songs to allow them to be searched for and added to automatically
generated genre playlists
- 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
- Import YouTube playlists or channels from admin area
- Import Album to associate Discogs album data with media in bulk
- Bulk admin management of songs
- Create songs from scratch or from YouTube videos
- **YouTube**
- Monitor and manage API requests and quota usage
- Configure API quota limits
- YouTube video management
- **Users**
- Activity logs
- Profile page showing public playlists and activity logs
- Text or gravatar profile pictures
- Email or OIDC login/registration
- Preferences to tailor site usage
- Password reset
- Data deletion management
- ActivityWatch integration
- Admin and moderator roles
- **Punishments**
- Ban users
- Ban IPs
- **News**
- Admins can add/edit/remove news items
- Markdown editor
- **Night Mode**
- **Administration**
- Admin area to manage instance
- Configurable data tables
- Reorder, resize, sort by and toggle visibility of columns
- Advanced queries
- Bulk management
- View backend statistics
- Limited administration privileges granted to moderators
---
## Contact
Get in touch with us via email at [core@musare.com](mailto:core@musare.com).