mirrors/raycast-linux
1
0
Fork 0
mirror of https://github.com/ByteAtATime/raycast-linux.git synced 2025-08-31 03:07:23 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
Raycast-compatible launcher for Linux
393 commits 6 branches 2 tags 41 MiB
Find a file
ByteAtATime 0071eae209
feat: switch to nightly deployments with artifacts
2025-07-12 19:33:58 -07:00
.github/workflows feat: switch to nightly deployments with artifacts 2025-07-12 19:33:58 -07:00
.vscode style: formatting 2025-06-11 14:58:11 -07:00
images docs: add readme 2025-07-11 13:52:33 -07:00
packages/protocol refactor(rpc): migrate to generic RPC proxy for sidecar commands 2025-07-03 09:43:27 -07:00
sidecar ci: add github action for building 2025-07-12 16:26:24 -07:00
src fix(actions): spread original props to action definition 2025-07-11 13:26:59 -07:00
src-tauri feat: use linux capabilities to set up file permissions 2025-07-12 18:42:36 -07:00
static Initial commit 2025-06-10 11:24:18 -07:00
.gitignore Initial commit 2025-06-10 11:24:18 -07:00
.prettierignore style: formatting 2025-06-11 14:58:11 -07:00
.prettierrc feat: add prettier and eslint 2025-06-11 14:55:40 -07:00
components.json feat: initialize shadcn 2025-06-10 11:39:02 -07:00
eslint.config.js chore(eslint): add global ignores for src-tauri and sidecar 2025-07-09 11:03:24 -07:00
package.json ci: add github action for building 2025-07-12 16:26:24 -07:00
pnpm-lock.yaml test(frontend): add vitest for unit and component testing 2025-07-06 15:09:06 -07:00
pnpm-workspace.yaml feat: add sidecar protocol i/o checking with Zod 2025-06-12 19:35:42 -07:00
README.md docs: fix soulvercore link 2025-07-11 13:55:11 -07:00
svelte.config.js style: formatting 2025-06-11 14:58:11 -07:00
tsconfig.json test(frontend): add vitest for unit and component testing 2025-07-06 15:09:06 -07:00
vite.config.js test(frontend): add vitest for unit and component testing 2025-07-06 15:09:06 -07:00
vitest-setup-client.ts test(frontend): add vitest for unit and component testing 2025-07-06 15:09:06 -07:00

README.md

Raycast for Linux

An open-source, Raycast-inspired launcher for Linux.

GIF of Raycast Linux, showing off its main features

Disclaimer: This is a hobby project and is not affiliated with, nor endorsed by, the official Raycast team.

✨ Features

This launcher aims to recreate most of Raycast's core features on Linux:

  • Extensible Command Palette: The core of the application. Search for and launch applications, run commands, execute quicklinks, and more.
  • Extension Support: Run extensions built Raycast's API. Features a built-in store to browse and install extensions from the official Raycast Store.
  • Powerful Calculator: A smart calculator integrated directly into the search bar, powered by SoulverCore. It handles unit conversions, currency, and complex math expressions.
  • Clipboard History: A searchable history of everything you've copied, with support for text, images, links, and colors.
  • Snippets: Create and manage text snippets that can be expanded anywhere on your system. Supports dynamic placeholders for dates, clipboard content, and more.
  • AI Integration: Connects to OpenRouter to bring the power of various AI models directly into the launcher.
  • And more to come!

🧩 Extension Compatibility

While the goal is to support a wide range of Raycast extensions, there are some inherent limitations due to the differences between macOS and Linux. Common reasons an extension might not work include:

  1. macOS-specific APIs: Many extensions rely on native macOS features like AppleScript (runAppleScript), hardcoded paths (/Applications/), or specific system libraries that do not exist on Linux.
  2. Native Binaries: Extensions that bundle pre-compiled binaries for macOS will not work. Similarly, extensions that use Swift to interact with the operating system won't work either.
  3. Assumed Permissions: Extensions may assume they have access to macOS-specific permissioned data (like Contacts or Calendars) which have no direct equivalent.

🚀 Getting Started

To get the project running locally, you'll need to set up the development environment.

Prerequisites

  • Rust: Install via rustup.
  • Node.js: Use a recent LTS version. pnpm is the package manager for this project (npm i -g pnpm).
  • Tauri Prerequisites: Follow the official Tauri guide to install system dependencies
  • Swift Toolchain: The calculator feature uses a Swift wrapper around SoulverCore.

Installation & Running

  1. Clone the repository:

    git clone https://github.com/ByteAtATime/raycast-linux.git
cd raycast-linux

  2. Install dependencies: This project uses a pnpm workspace. Install all dependencies from the root directory.

    pnpm install

  3. Build the Node.js sidecar binary: This step compiles the JavaScript plugin host into a binary that Tauri can execute.

    pnpm --filter sidecar build

  4. Run in development mode: This command will launch the Tauri application with hot-reloading for the frontend.

    pnpm tauri dev

🙏 Acknowledgements

This project stands on the shoulders of giants:

  • A huge thank you to the team behind the original Raycast.
  • The powerful calculator is powered by SoulverCore by Acqualia. Special thanks to Zac for getting me a Linux build -- on his vacation, no less!

📜 License

This project is licensed under the MIT License.