QuickLaunch

A lightweight macOS menu bar tool for quickly browsing, filtering, and opening development projects. Built for developers who switch between Roblox, Node, Rust, and other projects constantly.

---

Caution

This project is under active development. Expect bugs, changing file formats, and breaking changes between versions.

Features

Smart Search Instantly filter projects by name as you type.

Project Detection Automatically detects project types:

• Roblox (via default.project.json)
• Git repositories
• Node (package.json)
• Rust (Cargo.toml)
• Docker (experimental)

Project Scanning Scans your Projects folder and builds a live list of all projects.

Last Opened Tracking Projects are sorted by most recently opened for quick access.

Custom Icons If a project contains Icon.png, it will be used instead of a default folder icon.

One-Click Launch Open projects directly in your preferred editor (VS Code or a custom app).

Roblox Studio Integration Launch Roblox projects directly into Studio using placeId, universeId, and userId (configured in settings).

To enable this for a project, create a file named quicklaunch.toml in the project's root folder with the following:

placeId = 123456789
universeId = 987654321

QuickLaunch will read this file automatically and use it to launch the project straight into Roblox Studio.

---

Requirements

• macOS 14+

---

Setup

QuickLaunch is distributed as a prebuilt app via GitHub Releases.

1. Go to the Releases page.
2. Download the latest QuickLaunch.zip (or .app) from the newest release.
3. Unzip it (if needed) and drag QuickLaunch.app into your Applications folder.
4. Launch it by double-clicking, or opening it via Spotlight.

Opening an unsigned app

Since QuickLaunch isn't code-signed, macOS Gatekeeper will block it on first launch. To open it:

1. Right-click (or Control-click) QuickLaunch.app and select Open.
2. In the dialog that appears, click Open again to confirm.

If that doesn't work:

1. Go to System Settings → Privacy & Security.
2. Scroll down to the Security section, where you'll see a message about QuickLaunch being blocked.
3. Click Open Anyway.

You only need to do this once. macOS will remember your choice for future launches.

Keeping QuickLaunch running in the background

QuickLaunch is a menu bar app, so it's meant to stay running in the background rather than being reopened each time. To have it launch automatically whenever you log in:

1. Open System Settings → General → Login Items & Extensions.
2. Under Open at Login, click the + button.
3. Select QuickLaunch.app from your Applications folder.
4. QuickLaunch will now start automatically each time you log in, and will live in your menu bar until you quit it.

---

First-Time Setup

1. Choose your Projects Directory in settings.
2. (Optional) Set your preferred code editor.
3. (Optional) Set your Roblox User ID.

---

Data Storage

QuickLaunch stores the following locally on your machine:

• Projects directory bookmark
• Preferred editor path
• Last opened timestamps

No data is sent anywhere. Everything stays on your device.