Cleaned up project structure more and simplified the app installation

This commit is contained in:
2025-12-20 05:41:48 -08:00
parent ca767df960
commit 4cb8b94445
5 changed files with 95 additions and 29 deletions

View File

@@ -1,27 +1,30 @@
# muzi
Self hosted music listening statistics
# Muzi
## Self-hosted music listening statistics
### Dependencies
- PostgreSQL
### Spotify Import Instructions (for testing and development):
- Navigate to the muzi project root dir
- Create a folder called "spotify-data"
- Inside the new "spotify-data" folder create a folder called "zip"
- Place all zip archives that you obtained from Spotify in this folder.
- Ensure the PostgreSQL server is running locally on port 5432.
- Run muzi.go
- All Spotify tracks that have > 20 second playtime will congregate into the muzi PostgreSQL database
### Installation Instructions (for testing and development) \[Only Supports Spotify Imports ATM\]:
1. Clone the repo:<br>```git clone https://github.com/riwiwa/muzi```
2. Copy over all zip archives obtained from Spotify into the ```imports/spotify-data/zip/``` directory.
3. Ensure PostgreSQL is installed and running locally on port 5432.
4. Run the app with:<br>```go run main.go```
5. Navigate to ```localhost:1234/history``` to see your sorted listening history.
6. Comment out ```importsongs.ImportSpotify()``` from ```main.go``` to prevent the app's attempts to import the Spotify data again
### plans:
- Ability to import all listening statistics and scrobbles from lastfm, spotify, apple music
- daily, weekly, monthly, yearly, lifetime presets for listening reports
- ability to specify a certain point in time from one datetime to another to list data
- grid maker (3x3-10x10)
- multi artist scrobbling
- ability to change artist image
- webUI
- ability to "sync" scrobbles (send from a device to the server)
- live scrobbling to the server
- batch scrobble editor
### Roadmap:
- Ability to import all listening statistics and scrobbles from: \[In Progress\]
- lastfm
- spotify \[Complete\]
- apple music
- WebUI \[In Progress\]
- Full listening history with time \[Functional\]
- Daily, weekly, monthly, yearly, lifetime presets for listening reports
- Ability to specify a certain point in time from one datetime to another to list data
- Grid maker (3x3-10x10)
- Ability to change artist image
- Multi artist scrobbling
- Ability to "sync" offline scrobbles (send from a device to the server)
- Live scrobbling to the server
- Batch scrobble editor