fast-forward

Fast Forward

A window switcher for macOS built in Rust using the gpui framework by Zed

[!NOTE] This application was developed as a personal learning project to explore and understand Rust programming concepts. While functional, it may contain bugs or unexpected behaviors. I am not responsible for missed meetings because you got too efficient, carpal tunnel from excessive app switching, or your cat learning to manipulate your windows after watching you use this tool

How It Works

1. Press the right Command key to trigger Fast Forward (or left Command key + Tab if enabled in settings).
2. You can:
   • Type to search for the app you want.
   • Use Tab to highlight the next app in the list.
3. Release the Command key to switch to the selected app.
   • To hide or close the selected app, press Space or Escape instead of releasing the Command key.

Installation

1. Download the latest available DMG from releases page
2. Open the downloaded DMG file
3. Drag and drop the "Fast Forward.app" file to the Applications folder

You may see this message:

Apple could not verify "FastForward.dmg" is free of malware that may harm your Mac or compromise your privacy.

To resolve the problem, run the following command in Terminal:

xattr -d com.apple.quarantine ~/Downloads/FastForward.dmg

Development

Prerequisites

• Rust (stable toolchain)
• Xcode Command Line Tools
• protobuf: brew install protobuf
• swift-protobuf: brew install swift-protobuf

Building from Source

# Clone the repository
git clone https://github.com/yourusername/fast-forward.git
cd fast-forward

# Build in debug mode
cargo build

# Build in release mode
cargo build --release

# Run the application
cargo run

Code Quality

This project uses cargo fmt and cargo clippy to maintain code quality.

# Format code
cargo fmt --all

# Run linter
cargo clippy --all-targets -- -D warnings