Skip to content

Commit bb4ac7d

Browse files
authored
Update README.md
1 parent f5f08c1 commit bb4ac7d

File tree

1 file changed

+79
-1
lines changed

1 file changed

+79
-1
lines changed

README.md

Lines changed: 79 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,79 @@
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

Comments
 (0)