No description
Find a file
Txoldi 75d7baa4da
Merge pull request #2 from Txoldi/init_plugin
Fix plugin ID, name, and description for Obsidian submission
2025-11-20 21:52:12 +01:00
assets added README and LICENSE 2025-11-20 20:51:08 +01:00
commands fix limit bug and other small fixes 2025-11-20 15:36:07 +01:00
lastfm handle missing settings case 2025-11-20 18:51:30 +01:00
ui fix limit bug and other small fixes 2025-11-20 15:36:07 +01:00
utils plugin initialized to a working state 2025-11-19 14:41:24 +01:00
.editorconfig use LF instead of CRLF (#28) 2022-04-15 14:13:31 -04:00
.eslintignore fix .eslintignore (#48) 2023-01-19 10:06:51 -05:00
.eslintrc add version bump script (#10) 2022-01-22 16:13:50 -05:00
.gitignore Update .gitignore (#25) 2022-01-28 10:34:53 -05:00
.npmrc add version bump script (#10) 2022-01-22 16:13:50 -05:00
AGENTS.md language 2025-09-05 09:10:47 -07:00
esbuild.config.mjs build: minify prod build 2023-11-15 14:10:43 -05:00
LICENSE added README and LICENSE 2025-11-20 20:51:08 +01:00
main.ts fix bug in settings 2025-11-20 19:25:49 +01:00
manifest.json Fix plugin ID, name, and description for Obsidian submission 2025-11-20 21:46:25 +01:00
package-lock.json plugin initialized to a working state 2025-11-19 14:41:24 +01:00
package.json updated package.json 2025-11-20 19:30:02 +01:00
README.md Improved README 2025-11-20 20:55:14 +01:00
settings.ts fix bug in settings 2025-11-20 19:25:49 +01:00
styles.css commented code 2025-11-20 20:59:37 +01:00
tsconfig.json Fix inconsistent indentation 2024-01-19 21:14:58 +02:00
version-bump.mjs build: only write new minAppVersion requirements to versions.json 2025-04-28 08:38:38 +02:00
versions.json Fix plugin ID, name, and description for Obsidian submission 2025-11-20 21:46:25 +01:00

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.fms API)
Album artwork (available for recent scrobbles and top albums)
Automatically generate Markdown notes into your chosen folder


📸 Preview


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!