memory.fm is a Python library, CLI tool, and web-based dashboard for exploring music listening history from Last.fm and Spotify.
Instead of focusing only on aggregate stats, it surfaces long-term and local patterns such as attachment, repetition, and obsessive listening, to help you revisit periods of your life through music.
Inspired by the idea of using music as a way to revisit memories.
- Import your complete listening history from Last.fm and Spotify.
- Fast incremental sync after the first import.
- Supports JSON/CSV exports from lastfmstats.
memory.fm focuses on how you listened, not just what you listened to.
Get a clean summary of your music listening history.
- View your top artists, albums, and tracks.
- Filter them by weekly, monthly, and yearly periods, or a custom date range.
- See how concentrated your listening was during a given period using Attachment Index.
- Find out whether you were deeply attached to a few tracks, albums, or artists, or broadly exploring.
-
Detect periods of intense, repeated listening to a single artist, album, or track. Streaks often correspond to emotionally significant moments or phases.
-
With Streaks Timeline, you can view an interactive, color-coded timeline of your listening streaks.
You have two UI options:
- Graphical Dashboard: A user-friendly graphical dashboard that runs inside your web browser.
- CLI: A command line tool with more granular control for power users.
The package should soon be available on PyPI. For now, you can install it directly from the repository using pip:
pip install "memory.fm @ git+https://github.com/shsiddhant/memory.fm.git"Requires Python>=3.10
Launch the interactive web dashboard:
memoryfm-guiThis opens a browser interface at http://localhost:8501 where you can:
- Import your listening history from Last.fm or Spotify
- Explore visualizations and analytics
- View your attachment patterns and listening streaks
For power users, the CLI offers more granular control:
# Import data from Last.fm
memoryfm import last.fm <your_username>
# Import from Spotify export
memoryfm import spotify path/to/my_spotify_data.zip --username <use_any_username>
# Load your import
memoryfm load <your_username>
# View top artists for the last month
memoryfm top artists --last month
See the CLI documentation for all available commands.
Use memory.fm programmatically in your own projects:
import memoryfm as mfm
# Load your listening history
sclog = mfm.from_lastfm_api(username="your_username",
tz="Asia/Kolkata")
# Filter by dates
filtered_sclog = sclog.filter_by_date("2025-09-12 10 PM", end="2025-09-13 10:40 AM")
# Calculate attachment index of order alpha
attachment = mfm.attachment(sclog, by="album", year=2024, alpha=2)See the API documentation for more examples.
Full documentation is available at: https://memoryfm.readthedocs.io
- Support for loading Spotify listening history exports
- CLI commands for loading, printing, exporting, filters, top charts, etc.
- API support for Last.fm
- Attachment Index
- Streaks and Streaks Timeline
- Time of Day / Season based analysis
- Memory Attachments and Timeline integration
- Spotify wrapped but make it nerdier
- Export options for data, visuals, and memory attachments
- Apple Music support
Check the issue tracker for more details.
Contributions are welcome - whether you’d like to fix a bug, suggest an improvement, or propose new ideas for memory.fm.
If you find a bug or have a feature request, please open an issue using the appropriate template in the issue tracker.
For detailed guidelines on contributing and development setup, see CONTRIBUTING.md.
This project is licensed under the MIT License.
Thanks to Felix Hagemans (felhag) for creating lastfmstats, which inspired parts of this project.