Songwriter Player

An advanced sidebar audio player for songwriting.

Obsidian's embedded audio unloads as the note scrolls, and playback cuts off. Songwriter keeps the player in its own side panel: scroll your lyrics as much as you like — the music keeps playing. Playback even survives closing the panel (the sound lives in the plugin, not in the UI).

Читаете по-русски? Есть русская версия README.

Features

• Right-sidebar panel — opened with the ribbon button (a note icon) or a command.
• Pickup from the note — the player takes the audio from the note you open (an embed ![[song.mp3]] or a link [[song.mp3]]). If music is already playing, it offers to switch with a small banner instead of interrupting. The mode is configurable: hybrid / always / manual.
• Track waveform:
  • single click — play from there (a click outside the loop zone clears the zone);
  • double click — set the marker;
  • press and drag — select an A-B zone;
  • drag a zone edge — move it (the cursor turns into ↔).
• Marker (⚑) — one point per track: mark the spot you keep coming back to while working on a song. "Play from marker" always starts there (with no marker — from the start). The marker is remembered per file.
• A-B loop zone — a selected fragment of the waveform plays in a loop; the zone start automatically becomes the marker, so "Play from marker" restarts the loop from its beginning. Seeking outside the zone by hand does not drag you back — the loop only kicks in when playback itself reaches the B edge. The zone is remembered per file; clear it by clicking outside it or with the Clear A-B loop zone command (the marker stays).
• Playlist — open a note holding several audio files and they line up as its playlist; open an audio file and every audio file next to it in the folder does. The list sits under the player (collapsible, remembers its state): the current track is highlighted, each row shows its play count and a ⚑ if the track has a marker, a click switches to it — and keeps playing if something was playing. ⏮ ⏭ walk the list, and the list survives ejecting the track, so you can pick the next one from it. Optionally the playlist plays through on its own; a track with an A-B zone keeps looping instead.
• Play count and total listened time — next to the track name (▶ 27 · 2h40m). A run only counts once 5 seconds have actually sounded (start-and-stop does not count; pause-and-resume keeps accumulating). Every loop-zone pass is a new run. Listened time accumulates only while sound is actually playing. Right-click the counter to reset both.
• Back to the track's note — click the track name (or Alt+D) to jump to the note the track was picked up from: if it is open in a tab, that tab is focused, otherwise the note opens; if the source is unknown, any note linking to the file is used.
• Unload track — the ⏏ button in the track row (or the Unload track command): the player clears and holds nothing while you work on other things; the hotkeys cannot fire by accident. Load a track again with the "Load audio from the note" button or just by opening a note with audio.
• Open externally (ported from the Open Audio Externally plugin): a ⧉ button to the right of the track name in the panel — and the same button next to every embedded audio player in notes. Click opens the file in the default app, right-click reveals it in the system explorer. Commands: Open track in default app, Reveal track in system explorer. The embedded-player buttons can be turned off in settings.

The marker and the zone are visible right on the waveform (an orange flag and a highlighted fragment) — there are no separate indicators in the panel. Time, buttons and volume share a single line under the waveform.

Hotkeys (defaults)

All commands can be rebound in Settings → Hotkeys. The Russian keyboard layout is duplicated out of the box.

Command	Keys
Play from marker (or from start)	Alt+X
Stop (double press: the next Alt+X plays from the start, marker intact; triple: the marker and the zone are deleted)	Alt+C
Set marker at current position	Alt+Z
Play/Pause	Alt+P
Open track's note	Alt+D
Seek back / forward	Alt+, / Alt+.
Previous / next track in the playlist	Alt+B / Alt+N
Play slower / faster (one bpm a step, the key stays put)	Alt+- / Alt+=
Transpose down / up a semitone (desktop only)	Alt+PageDown / Alt+PageUp
Play as recorded again — speed and key	Alt+0

Without default keys: Clear marker, Clear A-B loop zone, Load audio from current note, Open player panel, Unload track, Open track in default app, Reveal track in system explorer.

Settings

Besides the basics (pickup mode, seek step, start from marker) there is a playlist section (whole folder as a playlist, play the playlist through) and a fine-tuning one: the play-count threshold, the double-stop window, the waveform height, and the embedded-player button.

Data

Markers, loop zones and counters are stored in the plugin's data.json, keyed by the audio file path; when a file is renamed inside the vault, its data moves along automatically.

The interface follows Obsidian's language (English, or Russian when the app is set to Russian), works on desktop and mobile ("open externally" needs desktop).

Building

npm install
npm run build   # tsc typecheck + esbuild → main.js
npm run dev     # watch mode
npm test        # bundles the real source and drives it against stubs

The tests need no framework: they bundle src/ exactly as it ships, run it with a stub obsidian module, and drive the result — so what is checked is the artifact users install, not a restatement of the logic. The settings suite guards the round trip through data.json, where a field added to the type but forgotten in the migration is written faithfully and then dropped on the next start.

License

GNU AGPL-3.0. The plugin bundles essentia.js 0.1.3 (Music Technology Group, Universitat Pompeu Fabra) for tempo and key detection — it is licensed under the AGPL-3.0, so the combined work is too. The essentia sources are at https://github.com/MTG/essentia; the copy shipped inside main.js is the unmodified npm build.

Using the plugin carries no obligations. Distributing a modified version does: the source has to stay available under the same license.

---

Author: mrrepac · AGPL-3.0