|
1 | | -# MiniMediaMetadataAPI |
| 1 | +# MiniMedia Metadata API |
| 2 | +At last, an self-hosted Metadata API that supports multiple providers (Spotify, Tidal, MusicBrainz) |
| 3 | + |
| 4 | +The Restful API is quite straightforward, still a work in progress but does work |
| 5 | + |
| 6 | +It's using the same database as https://github.com/MusicMoveArr/MiniMediaScanner |
| 7 | + |
| 8 | +So you can already start using the metadata you synchronized in the database |
| 9 | + |
| 10 | +Loving the work I do? buy me a coffee https://buymeacoffee.com/musicmovearr |
| 11 | + |
| 12 | +## Used by projects, |
| 13 | +https://github.com/MusicMoveArr/MusicMover |
| 14 | + |
| 15 | +# Supported Providers |
| 16 | +1. MusicBrainz |
| 17 | +2. Tidal |
| 18 | +3. Spotify |
| 19 | + |
| 20 | +# Features |
| 21 | +1. Low memory footprint (<250MB) |
| 22 | +2. Postgres support |
| 23 | +3. Search Artists Metadata by ProviderType (Any, Tidal, MusicBrainz, Spotify) |
| 24 | +4. Search Albums Metadata by ProviderType (Any, Tidal, MusicBrainz, Spotify) |
| 25 | +5. Search Tracks Metadata by ProviderType (Any, Tidal, MusicBrainz, Spotify) |
| 26 | + |
| 27 | +## Docker compose |
| 28 | +``` |
| 29 | +services: |
| 30 | + minimediametadataapi: |
| 31 | + container_name: MiniMediaMetadataAPI |
| 32 | + deploy: |
| 33 | + resources: |
| 34 | + limits: |
| 35 | + memory: 256M |
| 36 | + hostname: MiniMediaMetadataAPI |
| 37 | + image: musicmovearr/minimediametadataapi:main |
| 38 | + ports: |
| 39 | + - target: 8080 |
| 40 | + published: "56232" |
| 41 | + protocol: tcp |
| 42 | + restart: unless-stopped |
| 43 | + volumes: |
| 44 | + - type: bind |
| 45 | + source: /DATA/AppData/minimediametadataapi/config/appsettings.json |
| 46 | + target: /app/appsettings.json |
| 47 | +``` |
| 48 | + |
| 49 | +## Docker Run |
| 50 | +``` |
| 51 | +docker run -d \ |
| 52 | + --name MiniMediaMetadataAPI \ |
| 53 | + --hostname MiniMediaMetadataAPI \ |
| 54 | + --memory 256m \ |
| 55 | + -p 56232:8080 \ |
| 56 | + --restart unless-stopped \ |
| 57 | + -v /DATA/AppData/minimediametadataapi/config/appsettings.json:/app/appsettings.json \ |
| 58 | + musicmovearr/minimediametadataapi:main |
| 59 | +``` |
| 60 | + |
| 61 | +## Example Configuration |
| 62 | +It's important you bind this file to /app/appsettings.json as above in the docker examples |
| 63 | + |
| 64 | +Change the connectionstring to your own postgres database |
| 65 | + |
| 66 | +``` |
| 67 | +{ |
| 68 | + "Logging": { |
| 69 | + "LogLevel": { |
| 70 | + "Default": "Information", |
| 71 | + "Microsoft.AspNetCore": "Warning" |
| 72 | + } |
| 73 | + }, |
| 74 | + "AllowedHosts": "*", |
| 75 | + "DatabaseConfiguration":{ |
| 76 | + "ConnectionString": "Host=192.168.1.1;Username=postgres;Password=postgres;Database=minimedia;Pooling=true;MinPoolSize=5;MaxPoolSize=100;" |
| 77 | + } |
| 78 | +} |
| 79 | +``` |
0 commit comments