CaptionLayer - GitLite

KO | EN

gitlite — search

#json #svg #rust #cross-platform #developer-tools #shell #gpt #java #markdown #hacktoberfest

CaptionLayer

(★ 14)

Lightweight macOS menu‑bar app that transcribes system audio output.

File Explorer

ZIP Download

- Info.plist.template
- build_app.sh
- build_installer.sh
- render_dmg_background.swift
- render_symbol.swift
- - AppConfig.swift
  - AppMain.swift
  - AudioDeviceSelector.swift
  - CoreAudioUtils.swift
  - EnvLoader.swift
  - NotchUI.swift
  - StatusBarController.swift
  - SystemAudioTap.swift
  - TranscriptionController.swift
.gitignore
Package.swift
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`swift`

View Details ▼

Create, run, and build Swift projects.

swift repl

Start a REPL (interactive shell):

swift {{file.swift}}

Execute a program:

swift package init

Start a new project with the package manager:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div>
    <a href="https://www.loom.com/share/6ad520e4ef004ee69b66279734750089">
      <p>Watch Demo 🎤</p>
    </a>
    <a href="https://www.loom.com/share/6ad520e4ef004ee69b66279734750089" target="_blank">
      <img style="max-width:600px;" src="https://cdn.loom.com/sessions/thumbnails/6ad520e4ef004ee69b66279734750089-21c09d832a17f18b-full-play.gif#t=0.1">
    </a>
</div>
  
CaptionLayer is a lightweight macOS menu‑bar app that transcribes what your computer plays. It listens to system output audio (not the microphone) and displays live text in a small notch‑style overlay.

Inspired by [Notchie](https://www.notchie.app/).

## Features
- Real‑time transcription for system audio.
- Minimal UI that stays out of the way.
- Simple token management from the menu bar.

## Requirements
- macOS 14.4+ (uses the new CoreAudio output tap API)
- ElevenLabs API key (for the realtime transcription service)

## Install
1. Download the installer DMG.
2. Drag **CaptionLayer.app** to **Applications**.
3. Launch the app from Applications.

## First Run
On first launch, CaptionLayer will prompt for your ElevenLabs API key.  
If the key is missing or invalid, the app will tell you and quit.  
macOS will also prompt for system audio capture permission.

## Token Management
Use the menu‑bar icon:
- **Remove Token** clears the stored key and quits the app.

On next launch, you’ll be asked to enter a new key.

## Usage
- Once running, CaptionLayer transcribes system audio and shows text in the overlay.
- Use the menu‑bar icon to hide/show the panel or quit.

## Permissions
- **System Audio**: required to capture output audio.

## Notes
- CaptionLayer listens to system output audio only (it does not use the microphone).
- The API key is stored locally using macOS user defaults.

## Run From Source (for developers)
```
swift run
```

## Troubleshooting
- **No text appears**: verify your API key is valid.
- **App quits with a token error**: remove the token and enter a new one.

## Build (for developers)
```
swift build -c release
```

## Build App Bundle (for developers)
```
./scripts/build_app.sh
```

## Package (for developers)
```
./scripts/build_installer.sh
```