# 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.