[iyekChen]

Description

Browse, organize, and listen to your Ableton Live projects from Raycast: tags, pins, notes and lyrics, bounce playback, and collections for EPs and albums.

Testing: set Projects Folder to a folder containing Ableton project folders (each with a .als file), then open Search Projects.

About the bundled binary

assets/audio-player is a small Swift helper that plays bounces in the background and measures audio features for the energy score. Node can't do either efficiently.

• Source: swift/AudioPlayer.swift. It uses only Foundation, AVFoundation, Accelerate, and Darwin, with no networking and no third-party code.
• Build: npm run build:player (swiftc -O, arm64 + x86_64, merged with lipo). It's ad-hoc signed and reproducible: rebuilding with Swift 6.4 gives the same SHA-256, f3463c2dd1d8f9de7796d4a253acf5507fe386de149ef8a67f333afccb415cc9.
• Runtime: it only reads the audio files the user plays or analyzes, and only writes small command/status files in environment.supportPath.
• Install: it's copied to environment.supportPath, made executable, and has its quarantine attribute removed.

Happy to follow your preferred process for binaries, including having the Raycast team build it from source.

Screencast

2026-10-22.at.07.51.52.-.Raycast.APM.mp4

Checklist

• I read the extension guidelines
• I read the documentation about publishing
• I ran npm run build and tested this distribution build in Raycast
• I checked that files in the assets folder are used by the extension itself
• I checked that assets used by the README are placed outside of the metadata folder

[raycastbot]

Congratulations on your new Raycast extension! 🚀

We're currently experiencing a high volume of incoming requests. As a result, the initial review may take up to 15 business days.

Once the PR is approved and merged, the extension will be available on our Store.

[greptile-apps]

Confidence Score: 3/5

[Medium impact] The extension affects local Ableton project workflows for its users.

The PR is not ready to merge because replacement projects can inherit saved data and collection edits can still lose renamed track numbers.

Findings

1.  Unrelated projects share saved data ▶

Fix with agent prompt

### Issue 1
extensions/ableton-project-manager/src/core/projects/load-projects.ts:undefined-53
Project identity is only the folder name. Switching `projectsFolder` to another library containing `Song` applies the first library's tags, collections, and external bounces to the unrelated `Song`. Replacing a project with a new same-named folder between scans has the same result because `diffSnapshots` compares names before checking folder identity. Include the library and folder identity in saved project references.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

Summary

Adds an Ableton Live project manager with project search, collections, bounce playback, and Markdown notes.

Since the previous review:

• Ableton projects show up in a searchable list with tags and collections.
• Collections organize tracks and show their relative audio energy.
• Bounce lists combine project audio with registered external files and folders.
• Project notes and lyrics can live in Markdown files and follow project changes.
• Finder changes can update project records and recover data when a project returns.
• Set lists show Ableton project details and let users manage their files.

_{Reviews (2) · Last reviewed commit: "fix: 处理 Store 审查意见（Preferences 类型、Finder..." · Reviewed by Greptile}

[greptile-apps]

Unrelated projects share saved data

Project identity is only the folder name. Switching projectsFolder to another library containing Song applies the first library's tags, collections, and external bounces to the unrelated Song. Replacing a project with a new same-named folder between scans has the same result because diffSnapshots compares names before checking folder identity. Include the library and folder identity in saved project references.

Knowledge Base Used: Extension command implementation patterns

Prompt To Fix With AI

This is a comment left during a code review.
Path: extensions/ableton-project-manager/src/core/projects/load-projects.ts
Line: 53

Comment:
**Unrelated projects share saved data**

Project identity is only the folder name. Switching `projectsFolder` to another library containing `Song` applies the first library's tags, collections, and external bounces to the unrelated `Song`. Replacing a project with a new same-named folder between scans has the same result because `diffSnapshots` compares names before checking folder identity. Include the library and folder identity in saved project references.

**Knowledge Base Used:** [Extension command implementation patterns](https://app.greptile.com/raycast/-/custom-context/knowledge-base/raycast/extensions/-/docs/extension-command-implementation.md)

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

[iyekChen]

Acknowledged. Projects are keyed by folder name within the configured Projects Folder, and the extension is designed around a single library. Changing this would mean migrating every stored reference, so I've documented it under Known limitations for now and will revisit it later.

[greptile-apps]

Lyrics settings hide existing notes

Changing whether notes and lyrics share a folder also changes existing note file names. With notes in a custom folder and lyrics in project folders, notes use Song.md. Setting lyrics to that same custom folder makes notes suddenly use Song @Notes.md, without moving or finding the existing note. Keep existing documents reachable when this preference changes.

Prompt To Fix With AI

This is a comment left during a code review.
Path: extensions/ableton-project-manager/src/core/docs/docs.ts
Line: 307

Comment:
**Lyrics settings hide existing notes**

Changing whether notes and lyrics share a folder also changes existing note file names. With notes in a custom folder and lyrics in project folders, notes use `Song.md`. Setting lyrics to that same custom folder makes notes suddenly use `Song @Notes.md`, without moving or finding the existing note. Keep existing documents reachable when this preference changes.

---

For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.

[iyekChen]

Acknowledged. This only happens when the user changes whether notes and lyrics share a folder, which is rare and explicit. Renaming files automatically on a preference change felt riskier than documenting it, so it's now listed under Known limitations.

[0xdhrv]

Hey @iyekChen 👋

Thanks for your contribution 🔥 This is a really thorough project manager for Live: collections with track roles, bounce playback that keeps going after Raycast closes, and the Trash-restore safety net are all great touches.

We already have an extension in the Store for Ableton Live projects:

• Ableton Live by @dch09

It already searches your local Live projects. Could you add your features there instead, for example tags, collections, bounce playback, and notes and lyrics as new commands, with project search folded into its existing command? That keeps Live users in one place and makes them easier to discover. You can find how to contribute to an existing extension here. If there's a workflow that really can't fit there, let me know which one and we can take another look.

This would help avoid duplication and keep Ableton Live tooling consolidated in one extension.
As mentioned in our extension guidelines here ↗

[iyekChen]

Hi @0xdhrv, thanks for the review.

I'd prefer to keep Ableton Project Manager (APM) as a separate extension. Some users just want to reopen a Set quickly, while others want to manage their whole project library. The Prepare an Extension for Store guide suggests creating a new extension when the changes "would be significant and might break other people's workflows", and I think this is one of those cases. Could you take another look?

1. They serve different purposes.

In the Ableton Live app, a project is a folder that holds one or more Sets (.als files, often different versions of the same song) and its bounces (exported mixes).

	Ableton Live extension	APM
Purpose	Quickly open a Set	Manage a project library
Lists	Every Set Spotlight finds on the Mac, with no setup	Projects in a Projects Folder you choose, each with its Sets
Search, open, pin	✓	✓
Beyond that	—	Tags, collections, bounce playback, notes and lyrics (details below)

This is close to the guide's Spotify example: a lightweight extension and a deeper one that needs setup are kept apart, because merging them "would only make things more complicated".

2. Merging would replace the Ableton Live extension more than extend it.

After a merge, APM would make up almost all of the extension, and the current search and favorites would be a small part of it. Its current users, who came for a lightweight launcher, would get a library manager that asks them to choose a Projects Folder, has ten preferences, and bundles a native binary. Keeping them separate lets each group install what they need.

To avoid confusion in the Store, I can make the difference clear in the description and README, or adjust the title or subtitle.

For context, I'm actively maintaining APM, and its Ableton-specific code sits behind an adapter so I can build a Logic Project Manager on the same foundation.

What APM adds, in detail

• Tags and filters: tag projects by stage and genre, and filter by either. A separate Manage Tags command edits stages, genres, and track roles, and tags many projects at once.
• Collections: ordered tracklists with an Unsorted area for projects not placed yet, track numbers, roles, and energy scores to guide the order. Energy compares how dense, bright, and busy each track's bounce sounds within the collection. A collection can be queued in your audio player as a playlist.
• Bounce playback: preview a project's latest bounce with a bundled native player, including bounces saved outside the project folder and linked to it. Playback continues after you close the Raycast window, play/pause, seek, and restart work from the keyboard, and a toast shows progress. In Browse Bounces, any bounce can also be opened in Quick Look.
• Notes and lyrics: Markdown files for each project, saved in the project folder or a folder you choose, like an Obsidian vault. Edits from any editor show up right away. Templates support {{date:format}}, and YAML frontmatter is hidden in the preview and kept when editing in Raycast.
• Set details: the tempo, key, and time signature of every Set in a project.
• Sort and group: sort by modified date, created date, or name, and group by modified or created date. Browse Bounces can also sort by file size and group by where each bounce is saved.
• File actions: rename projects, Sets, and bounces, duplicate projects and Sets, move any of them to the Trash, and copy a project's latest bounce as a file to drop into a chat or another app.
• Data that follows the project: the list updates as projects change in Finder. Tags, collections, track numbers, roles, notes, and lyrics follow a renamed project and are restored if it's put back from the Trash within 30 days. If a drive goes missing, nothing is cleared.
• Raycast 2 conventions: standard Raycast 2 shortcuts for pin, reorder, copy, edit, duplicate, remove, and create.

[dch09]

Hey @iyekChen this looks cool af. I can happily remove an unmaintained extension of mine if that frees the way for this PR to be merged @0xdhrv

[iyekChen]

Thanks sooo much @dch09, glad you like it 🙌🏻
If possible, I'd love for both to stay, so your current users aren't affected.

[dch09]

Thanks sooo much @dch09, glad you like it 🙌🏻 If possible, I'd love for both to stay, so your current users aren't affected.

As far as I understand, your extension handles searching, opening, and pinning as well, rendering mine redundant; therefore, it can and most definitely should replace mine! ✅