zuletzt/README.md
2024-11-30 23:59:59 -05:00

53 lines
3.1 KiB
Markdown

# Zuletzt
**Zuletzt** gives you the statistics of your music listening habits.
Inspired by [Last.fm](https://last.fm), [Maloja](https://github.com/krateng/maloja), and [Lastfmstats.com](https://www.lastfmstats.com).
**Z**uletzt is written with [**Z**ig](https://github.com/ziglang/zig) and [Jetzig](https://github.com/jetzig-framework/jetzig) as a means of learning the
language, reintroducing myself to programming, and combining
the functionality of the aforementioned inspirations.
Zuletzt means "last" in German.
Licensed under MIT.
## To-Do List:
- [ ] Last.fm statistics
- [ ] Lastfmstats.com statistics[^1]
- [ ] Collections
- [ ] Import from Discogs[^2]
- [ ] Import listening history
- [ ] From Lastfmstats.com (.json file)[^3]
- [ ] From Last.fm (authentication)
- [ ] From Spotify (.json file)
- [ ] From other streaming services[^4]
- [ ] Import rules
- [ ] Simple find/replace
- [ ] User-defined regex
- [ ] Tags
- [ ] Genres
- [ ] MusicBrainz integration
- [ ] Concerts
- [ ] Import from Setlist.fm[^5]
- [ ] Ratings
- [ ] RYM integration[^6]
- [ ] Rank songs
- [ ] Custom statistics[^7]
- [ ] "Playlists"[^8]
[^1]: I do not intend to exactly replicate all the statistics Lastfmstats.com provides, but I would at least like to give the user the option to see those kinds of statistics, or generate them themselves (see 7).
[^2]: I do not intend to provide the level of granularity that Discogs provides, but a simple toggle that means "I own some version of this release" is all that is necessary.
[^3]: I have not investigated any other service for downloading your listening history from Last.fm, but providing the listening history as a JSON rather than a CSV is highly preferred. I may eventually provide my own way of downloading Last.fm data as a JSON, but I would prefer to allow users to enter their username, or authenticate, and avoid needing to upload a file altogether.
[^4]: I only intend to allow imports from Last.fm and Spotify at the moment because those are the only data sources I currently rely on. To that extent, I imagine I could import from other sources as well fairly easily, although I do not know what their data dumps look like.
[^5]: I only intend to allow imports from Setlist.fm at the moment because that is the only data source I currently rely on.
[^6]: RYM has the most data, and once it has an API, will be the only user-driven review site that *has* an API. In this context, "integration" simply means displaying the critic score and user score next to the album. You will be able to write reviews and ranks songs/albums(/artists?), but not for them to be published to RYM.
[^7]: I envision something akin to the Custom Reports from [Actual Budget](https://github.com/actualbudget/actual) that will allow users to create their own ways of rating/ranking songs/albums, and view their listening habits.
[^8]: Misleading title, but same functionality as "Lists" on AlbumOfTheYear, although I would like to allow albums and songs to appear on the same list.