convez.ai
SkillProdutividadeIniciante
codyhxyz

Spotify Notes Plugin

codyhxyz/spotify-notes-plugin

Anotações privadas sincronizadas com sua reprodução no Spotify em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que captura notas com timestamp sobre a música que você está ouvindo no Spotify, direto do terminal, sem autenticação ou troca de contexto. Organiza automaticamente as anotações em arquivos markdown por faixa, permitindo recall instantâneo e busca entre anos de escuta.

Instalação

$npx convez-ai codyhxyz/spotify-notes-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Capturar insights musicais sem abandonar o fluxo de trabalho
  • Manter um diário pessoal de observações sobre músicas e produção
  • Pesquisar e recuperar notas antigas sobre faixas específicas ou temas

Veredito

Solução criativa que elimina atrito real — zero configuração, zero auth, integração direta com app nativo. Implementação elegante usando IPC do Spotify. Recomendado para quem quer capturar pensamentos de forma rápida sem deixar o terminal.

README

A tradução para o português deste README ainda está na fila.

spotify-notes

A Claude Code plugin for keeping a private journal on whatever Spotify is playing, from inside your terminal, with no auth dance.

Before → After

Before. You hear a moment in a song. You know the thought will be gone in forty seconds. You swipe out of Spotify, open Notes, fumble the song title, type a half-sentence, swipe back, already can't remember what you noticed.

After. In whatever Claude Code session you already have open, you say note: that piano intro keeps refusing the downbeat. The plugin reads what Spotify is playing right now, appends the thought with a timestamp to a per-track markdown file, and hands control back. Zero context switch.

What you walk away with

  • A growing folder of markdown files, one per track you've cared enough about to annotate — each with a clean running log of your thoughts
  • Instant recall: "what did I write about this song" pulls the file for whatever's playing right now
  • Search across years of listening: "find notes mentioning piano" greps the whole archive in one shot
  • No Spotify API keys, no OAuth, no cloud — the plugin uses the desktop app's own IPC (AppleScript on macOS, playerctl on Linux)

Install

/plugin marketplace add codyhxyz/codyhxyz-plugins
/plugin install spotify-notes@codyhxyz-plugins

Or directly from this repo:

/plugin marketplace add codyhxyz/spotify-notes-plugin
/plugin install spotify-notes@spotify-notes

Usage

Open any Claude Code session with the Spotify desktop app running. Say any of:

You typeWhat happens
note: that piano at 2:14 is killing meAppends the note to <current-track>.md with a timestamp
take a note about this songAsks what you'd like to jot, then saves it
what did I write about this song?Reads the current track's file and shows all your notes
what songs have I taken notes on?Lists your annotated tracks, newest first
find my notes about pianoGreps every saved note for "piano" and shows matches

Notes live at ${CLAUDE_PLUGIN_DATA}/notes/<track-id>.md. Each file is plain markdown you can open in any editor.

Examples

Example 1 — quick capture.

You: note: marcus is in the low part of his voice, tired, not preaching yet

Claude: Saved to After the Storm — Mumford & Sons.

A new file at notes/4cOdK2wGLETKBW3PvgPWqT.md now contains frontmatter + a timestamped H2 section with your note. Next note on the same track appends below the first. Switch to a different song and the next note: lands in a different file.

Example 2 — recall.

You: what have I written about this one?

Claude: (reads notes/4cOdK2wGLETKBW3PvgPWqT.md and renders your prior H2 sections in order)

Example 3 — cross-song search.

You: find my notes about piano

Claude:

After the Storm — Mumford & Sons
  > held-breath piano keeps refusing the downbeat
Jesus, Etc. — Wilco
  > piano like rain, endless

How the song detection works

  • macOS: a one-liner AppleScript against the Spotify desktop app — tell application "Spotify" to get .... Works whether Spotify is focused or backgrounded. No permissions prompt beyond the first time you run it.
  • Linux: playerctl --player=spotify metadata ... over MPRIS. Requires playerctl installed (apt install playerctl / brew install playerctl on Mac if you prefer it there too).
  • Windows: not yet supported. Track detection via the native Spotify app on Windows is uglier (no MPRIS); PRs welcome.

If Spotify isn't running or isn't playing anything, the plugin tells you and stops. It will never silently invent a track name.

Why this exists

There's already a web app for this same idea. It works great but it forces a browser context switch, and it's gated on Spotify Premium (for the playback controls) and an OAuth session. This plugin is the terminal-native version: same goal (a song-indexed journal), none of the auth ceremony. Drop a thought while you're still in the middle of whatever else you were doing.

The plugin will not ever add:

  • Spotify Web API calls (no tokens to manage = no tokens to leak)
  • Cloud sync (your thoughts are your thoughts; git the folder if you want history)
  • Playback controls (that's what Spotify already does)

Development

# From inside the plugin dir:
claude --plugin-dir .
# Then in the Claude Code session:
/plugin-reload

Validate before shipping:

claude plugin validate .

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados