Sync Last.fm
Jaival18 downloadsSeamlessly fetch scrobbles, artists, albums and cover art from Last.fm and auto creates notes with properties which can be directly used in Base.
- Overview
- Scorecard
- Updates6
Seamlessly fetch scrobbles, artists, albums and cover art from Last.fm and auto creates notes with properties which can be directly used in Base.
Table of Contents
| Section | Description |
|---|---|
| Screenshots | Visual previews from tablet and mobile interfaces. |
| Features | A comprehensive list of what this plugin can do. |
| Installation | Step-by-step guide to installing the plugin manually. |
| API Key Guide | Steps to obtain your free Last.fm API key. |
| Feedback & Issues | How to report bugs or request features. |
| License & Legal | Copyright, AI, and licensing information. |
Screenshots
Features
- Incremental Syncing: Only pulls new tracks since your last sync, keeping API requests lightning fast.
- Artists & Albums Extraction: Dedicated folders for your top Artists and Albums, complete with playcounts and cover images.
- Smart Backlinking: Automatically links your scrobbled tracks directly into their respective Artist and Album notes.
- Custom Timezone Adjustments: Bypass your system clock and manually offset UTC time (e.g.,
5.5for IST) to ensure your scrobble dates are always perfectly accurate. - Re-stamp Existing Data: Change timezones? Re-calculate the local timestamps for all your existing track files instantly without needing to hit the Last.fm API.
- Historical Backfill: A dedicated option to pull historical tracks, artists, and albums up to custom limits.
Network Usage
Per Obsidian's community plugin policies, plugins must disclose their network activity.
This plugin requires an active internet connection to function. It makes outbound requests exclusively to the official Last.fm API (https://ws.audioscrobbler.com) to fetch your scrobble history, top artists, top albums, and track metadata based on the username and API key you provide.
Installation
From Obsidian Community (Recommended)
The easiest way to install and keep the plugin updated:
- Open Obsidian and go to Settings > Community Plugins.
- Turn off "Safe Mode" if you haven't already.
- Click Browse and search for Last.fm Sync.
- Click Install, then click Enable.
Alternatively, click here to open it directly in Obsidian: Install Last.fm Sync
Install Manually
If you prefer to install manually via GitHub Releases:
- Go to the Releases page of this repository.
- Download the latest
main.jsandmanifest.jsonfiles. - Open your file manager and navigate to your Obsidian Vault.
- Make sure you can see hidden files (enable "Show hidden files" in your file manager settings).
- Navigate to
.obsidian>plugins. - Create a new folder inside
pluginsnamedsync-last.fm. - Move the downloaded
main.jsandmanifest.jsonfiles into this newsync-last.fmfolder. - Restart Obsidian, go to Settings > Community Plugins, and turn off "Safe Mode".
- Toggle on Last.fm Sync in the plugin list.
Manually Build Yourself
If you want to compile the plugin from the source code:
- Clone this repository:
git clone https://github.com/jaival-11/lastfm-obsidian-plugin.git - Navigate to the directory:
cd lastfm-obsidian-plugin - Install the dependencies:
npm install - Build the plugin:
npm run build - Create a folder named
sync-last.fmin your vault's.obsidian/plugins/directory. - Copy the newly generated
main.jsandmanifest.jsoninto that folder. - Restart Obsidian and enable the plugin.
API Key Guide
To sync your data, you will need a free API key from Last.fm:
- Go to the Last.fm API Account Creation page.
- Log in with your Last.fm account if you aren't already logged in.
- Fill out the application form (you only need to provide an Application name, e.g., "Last.fm for Obsidian").
- Submit the form to generate your credentials.
- Copy the API Key (you do not need the shared secret) and paste it into the plugin's settings in Obsidian.
Feedback & Issues
If you run into any bugs, have a feature suggestion, or just want to help improve the plugin, feel free to open an issue!
License & Legal
Disclaimer: This plugin is an unofficial tool and is not affiliated with, endorsed, or sponsored by Last.fm.
AI Disclaimer: Documentation and code for this project were created with the assistance of Artificial Intelligence.
No Warranty: This software is provided "as is", without warranty of any kind, express or implied. The author shall not be liable for any claims, damages, data loss, or other liability arising from, out of, or in connection with the software or the use thereof. Use at your own risk.
This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by Jaival