Audio PlugList

Playlist-based audio player for Obsidian. Point a playlist at a vault folder (auto-index audio files), an external link (with multi site support), then control playback from a clean tab view and a compact footer mini-player with shuffle/repeat, optional fade-out stop, and hotkey support.

Version: 1.2.6 - Obsidian: 1.5.0+ - Platforms: Desktop & Mobile

---

✨ Features

• Playlists
  • Create from a Folder (recursively indexes supported audio files).
  • Create from a Link (external site support).
• Footer mini-player with segmented controls (⏮ ⏯ ⏭ ⏹ 🔀 🔁), seek, volume, and a marquee Now Playing title.
• Tab view showing current playlist, track list, and playback controls.
• Shuffle / Repeat (Off - All - One).
• Fade-out on Stop with adjustable duration.
• Optional columns: show Artist and/or Album in the track list.
• Quick re-scan: index one playlist or Scan All from settings.
• File name parser: Artist - Title (em dash or hyphen) convenience.
• Hotkey support for assignable play/pause command per playlist.
• Browser Button for easy access to external links if wanted or needed.

Supported formats: mp3, wav, m4a, flac, ogg, aac.

---

📸 PREVIEW | Easily create playlists from internal library or external links

Library Based Playlist	External Link Based Playlist

---

📸 PREVIEW | Tab support, or Footer Mini-Player support (toggle mini-player on/off) with easy playlist selections

Tab View	Footer Only View

---

📸 PREVIEW | Easy menu and hotlink support

Settings	Hotlink Support

---

📦 Installation

Option A: Manual

1. Download the latest release assets (main.js, manifest.json, styles.css) from this repository.
2. Create a folder inside your vault at:
   .obsidian/plugins/audio-pluglist/
3. Copy the three files into that folder.
4. In Obsidian: Settings → Community plugins → Installed plugins → Enable “Audio PlugList”.

Option B: BRAT (before it’s in the Community store)

If you use the BRAT plugin:

1. In BRAT, add this repo’s URL: https://github.com/ragetrip/audio-pluglist
2. Let BRAT install and enable the plugin.

Community Store (once approved)

After the plugin is accepted into the Obsidian Community Plugin store, you’ll be able to install and update it directly from: Settings → Community plugins → Browse.

---

🚀 Usage

1. Open Settings → Audio PlugList.
2. Under Add New Playlist, choose:
   • From Folder → pick a vault folder to index audio.
   • From Link → paste a direct URL.
     Note: Please be aware that some services block external playback.
3. Click Scan on a playlist (or Scan All).
4. Open the view via Ribbon button (music icon) or the command “Open Audio PlugList.”
5. Use the tab controls or the footer mini-player to play, pause, skip, seek, adjust volume, toggle shuffle, and cycle repeat.

Tips

• File names like Artist - Title.mp3 or Artist - Title.flac are parsed into Artist/Title automatically.
• Turn on Show Artist / Show Album columns if you prefer richer lists.
• Enable Fade out on Stop and set a custom Fade duration (ms) if you like gentler stops.
• Footer mini-player will not directly control external link embeds, but will open the playlist to the working Tab view with controls.

---

⚙️ Settings Overview

• Playlists (dynamic list)
  • Name (optional label used in menus/views)
  • Folder (for folder playlists) + Browse + Scan now
  • Link (for link playlists)
  • Delete playlist
• Re-scan all playlists - Index local folder playlists, re-sync external link connections. Also available on Tab and Footer Mini-Player.
• YouTube privacy (youtube-nocookie.com) - Assigns privacy-enhanced domain for youtube embeds to help with Error 153 from blocked youtube links.
• Show Album in titles - Based on local file data.
• Show Artist in titles - Based on local file data.
• Show Footer mini-player - Toggles Footer Mini-Player on/off.
• Fade out on Stop - Toggle to enable/disable a user configured fade out on Stop command.
• Fade duration (ms) - Adjust by ms to user preferred amount.

---

🔍 Known Limitations

• External links: Some linked playlists require log-in; some services block external playback. Re-scan playlis(s) feature added to help re-attempt broken links.
• Mobile platforms Behavior depends on OS media policies (e.g., background playback limits).

---

📝 Changelog

1.2.6 - Release Notes

• First expected community release of Audio PlugList.
• Dynamic playlists (Folder/Link), footer mini-player, shuffle/repeat, fade-out stop, artist/album columns, and scan tools.
• Hotkey support for single command play/pause or external link call.
• Added FULLGUIDE.md for detailed guide and troubleshooting tips.

---

🤝 Contributing

Bug reports and PRs are welcome. Please include:

• Environment (OS, Obsidian version), repro steps, expected vs. actual behavior.
• If it’s a feature request, a short mockup or example helps.

---

📄 License

This project is licensed under the MIT License. See LICENSE for details.

---

☕ Support & More Plugins

If you like this plugin and want to support development, you can Buy Me a Coffee.

Check out my other Obsidian plugins and projects here: My GitHub Repositories.