memory.fm
=========

**memory.fm** is a Python library, CLI tool, and web-based dashboard for exploring your music listening history from Last.fm and Spotify.

.. admonition:: What makes it different?
   :class: tip
   
   Instead of just showing *what* you listened to, memory.fm reveals *how* you listened - surfacing patterns like attachment, repetition, and obsessive listening to help you revisit periods of your life through music.


Key Features
------------

**Attachment Index**
   Measure listening concentration during any period

**Streaks**  
   Find periods of obsessive or repetitive listening

**Interactive Analytics**
   Explore patterns through visual dashboards and timelines

**Flexible Access**
   Python library, CLI, or web dashboard

Getting Started
---------------

.. grid:: 3
   :gutter: 4
   :padding: 2 2 0 0
   :class-container: sd-text-center

   .. grid-item-card:: QuickStart

      QuickStart guide for newcomers.

      +++

      .. button-ref:: quickstart
         :ref-type: ref
         :click-parent:
         :color: secondary
         :expand:

         Go to QuickStart

   .. grid-item-card:: API Reference

      Detailed description of package API.

      +++

      .. button-ref:: api
         :ref-type: ref
         :click-parent:
         :color: secondary
         :expand:

         Go to API Reference
   
   .. grid-item-card:: Dashboard Guide
      
      Using the interactive web interface

      +++

      .. button-ref:: quickstart.dashboard
         :ref-type: ref
         :click-parent:
         :color: secondary
         :expand:

         Go to Dashboard Guide
      
      


.. toctree::
   :hidden:
   :maxdepth: 3

   quickstart/index

.. toctree::
   :hidden:
   :maxdepth: 2

   references/index