Skip to content

blampe/hearring-aid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🦻 hearring-aid Discord

Hear what your LiDAR is missing.

This repo contains scripts for deploying and self-hosting a MusicBrainz instance in conjunction with L——'s metadata API.

Important

A hosted api.musicinfo.pro instance is provided as a service to the community. The software it's running is not my own, and I cannot guarantee its stability. If you'd like to help improve it, please reach out!

The process to use the provided api.musicinfo.pro instance varies depending on whether you're using Docker. Non-Docker users will need to update the SQLite database directly.

🚀 Docker Images

  • The simplest way to use the hosted instance is by changing your L—— image to one of the available tags.

    • This image is based on the upstream LinuxServer.io image, with a small nginx proxy that redirects metadata queries to api.musicinfo.pro.
  • Alternatively, if you're already using L—— plugin builds (hot.io or LinuxServer.io), you can use the Tubifarry Plugin to set a custom metadata server.

🛠️ Manual SQL (Non-Docker)

If you're not using Docker or don't want to use a forked image, you can override the default metadata server by inserting a row into your SQLite database:

INSERT INTO Config (Key, Value) VALUES ('metadatasource', 'https://api.musicinfo.pro/api/v0.4/');

To revert to the official metadata server:

DELETE FROM Config WHERE Key = 'metadatasource';

Tip

You might also be interested in rreading-glasses, which takes a similar approach for R——.

🧱 Self-Hosting

A step-by-step self-hosting guide is available using docker-compose. It walks through how to use the official musicbrainz-docker stack along with the L—— Metadata API image.

📖 Read the full guide

tl;dr: Vanilla MusicBrainz images work just fine with the open-source metadata server — it's just a little tricky to configure.

⚠️ Disclaimer

This software is provided "as is", without warranty of any kind, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, and noninfringement.

In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from or in connection with the software or the use or other dealings in the software.

This software is intended for educational and informational purposes only. It does not constitute legal, financial, or professional advice. The user assumes all responsibility for its use or misuse.

The user is free to use, modify, and distribute the software for any purpose, subject to the above disclaimers and conditions.

About

Hear what your LiDAR is missing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 6