# Last.fm Integration for Obsidian

Fetch data and create notes from your **Last.fm listening history** directly inside Obsidian.

This plugin lets you fetch:

**Recent scrobbles**  
**Top tracks, artists, and albums** (for any Last.fm period)  
**Weekly charts** (from → to weekly ranges via Last.fm’s API)  
**Album artwork** (available for recent scrobbles and top albums)  
Automatically generate Markdown notes into your chosen folder

---

## 📸 Preview

<p align="center">
  <img src="assets/lastfm_plugin_modal.png" width="500">
</p>

---

## ✨ Features

- **Recent scrobbles**
  - Most recent tracks you scrobbled (includes artwork of each track's album)
  - Select the number of tracks you want to pull from Last.fm (5, 10, 20, 50, 100)
- **Top Tracks / Artists / Albums**
  - Period-based (7day, 1month, 3month, 6month, 12month, overall)
  - Set a custom limit for how many results to fetch
- **Weekly charts**
  - Real chart-based weekly ranges from Last.fm (up to 20 years back !)
- **Automatic note creation**
  - Create notes to persist data in your vault
  - Choose a folder in which notes will be created
- **Album art included** when available (recent plays & top albums only)
- Clean UI modal with tabs
- Ribbon icon for quick access
- Fully local — only Last.fm API requests are made

---

## 🔧 Setup

1. Get a Last.fm API key  
   https://www.last.fm/api/account/create

2. In Obsidian:
   - Open **Settings → Community Plugins**
   - Enable **Third-party plugins**
   - Install this plugin manually (see below)
   - Enter your **API key**, **username**, and **output folder**

---

## 📦 Manual Installation

1. Clone this repo

2. Make sure your NodeJS is at least v16 (node --version)

3. `npm i` to install dependencies

4. `npm run build` to compile the code

5. Copy `main.js`, `styles.css`, `manifest.json` to your vault `VaultFolder/.obsidian/plugins/obsidian-lastfm-plugin/`

6. Reload Obsidian and enable the plugin.

---

## 🧾 License

MIT

---

## 🙏 Credits

Built by **Gorka Gómez**  
Uses the Last.fm public API.

---

## ⭐ Support

If you enjoy this plugin, consider starring the repo on GitHub!