radialsan
Cross-platform radial pie-menu launcher. Inspired by AutoHotPie.
Features
- Radial Menu — Hold a hotkey to show a pie menu at your cursor, release to execute
- 13+ Actions — Send keys, open URLs, run commands, Lua scripts, clipboard, media control, and more
- Visual Editor — WYSIWYG menu editor with live Canvas preview, drag-and-drop slice reordering
- App Profiles — Automatic menu switching based on the active window (title / process name)
- Hierarchical Submenus — Nest menus up to 3 levels deep
- Icon System — Lucide Icons + emoji picker
- Lua Scripting — Embedded Lua 5.4 for custom automation
- Import/Export —
.radialsan.json packages, AutoHotPie settings import
- i18n — English and Japanese
- Cross-platform — Windows, macOS, Linux
Tech Stack
| Layer |
Technology |
| Framework |
Tauri v2 (Rust) |
| Frontend |
React + TypeScript + Vite |
| Styling |
Tailwind CSS |
| Menu Rendering |
HTML5 Canvas |
| Input Capture |
rdev (global key press/release) |
| Input Simulation |
enigo |
| Window Detection |
x-win |
| Scripting |
mlua (Lua 5.4) |
Development
Prerequisites
- Node.js 20+
- Rust (stable)
- Platform dependencies:
- Linux:
sudo apt install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf libx11-dev libxdo-dev libxcb-shape0-dev libxcb-xfixes0-dev
- macOS: Xcode Command Line Tools, Accessibility permission for input capture
- Windows: WebView2 (included in Windows 10/11)
Setup
git clone https://github.com/uboar/radialsan.git
cd radialsan
npm install
Run (development)
cargo tauri dev
Test
# Rust tests
cd src-tauri && cargo test
# Frontend tests
npx vitest run
# TypeScript check
npx tsc --noEmit
Build
cargo tauri build
Permissions
| OS |
Permission |
Required For |
| macOS |
Accessibility |
Global hotkey capture (rdev) |
| macOS |
Screen Recording |
Window title detection (optional) |
| Linux (Wayland) |
input group |
Global input via /dev/input |
Project Structure
src/ # React frontend
components/
PieMenu/ # Canvas rendering, geometry, animation
Editor/ # Visual editor components
Layout/ # Sidebar, layout
pages/ # Dashboard, MenuEditor, Profiles, Settings
stores/ # Zustand state management
i18n/ # Translations (en, ja)
utils/ # Sharing, AutoHotPie import
src-tauri/ # Rust backend
src/
actions.rs # Action execution (sendKey, openUrl, Lua, etc.)
commands.rs # Tauri IPC commands
input_listener.rs # Global hotkey capture (rdev)
lua_engine.rs # Embedded Lua scripting
profiles.rs # Active window monitoring
settings.rs # Settings persistence (JSON)
tray.rs # System tray
License
MIT
