Skip to content

Repository files navigation

Velocity

Velocity

v0.1.1
vty.dev · open source by Inertia

Desktop phone companion for shortcuts and plugins.
Inspired by GTA’s in-game phone. Not affiliated with Rockstar Games or Take-Two Interactive.

Why this exists

Inspired by GTA’s in-game phone: a floating home screen on your desktop for shortcuts, themes, and plugins. Hide and show it with a hotkey (default Shift+Tab).

It’s a natural fit for the FiveM community, and for livestreamers who want quick access to apps, tools, and links without a Stream Deck. Built with gamers in mind for quick multitasking mid-match or mid-stream. Launch Discord, Spotify, browsers, games, custom tiles, wallpaper packs, and whatever else you wire up.

Screenshots

Velocity home screen   Velocity home tiles

Support

Platform Get it
macOS (Apple Silicon) v0.1.1 arm64 zip
macOS (Intel / universal) Build: ARCH=x86_64 or ARCH=universal ./scripts/build-mac.sh
Windows / Linux Build: ./scripts/build-desktop.sh

Install: unzip → drag Velocity.app to Applications → open (right-click → Open if Gatekeeper blocks). Full notes: docs/install.md.

Site: https://vty.dev · Optional tip toward Mac signing: vty.dev/#support

Develop

Node 20+, Rust (stable), platform WebView.

git clone https://github.com/InertiaUX/Velocity.git
cd Velocity
npm install
./scripts/run-dev.sh

Controls: Shift+Tab hide/show · Esc back · optional keyboard control in Settings.

./scripts/build-mac.sh
./scripts/build-desktop.sh
npm run build:web

Plugins

HTML tiles inside Velocity: DEVELOPERS.md · vty.dev/developers

Spotify example: create an app at the Spotify Dashboard, redirect http://127.0.0.1:18766/callback, paste the Client ID in the tile (never commit a secret). Premium required for remote playback.

Layout

apps/desktop/     Tauri 2 + React phone shell
apps/web/         Site (vty.dev)
packages/sdk/     @velocity/sdk
plugins/          Example plugins
docs/             Install, architecture, screenshots
scripts/          Dev / build helpers

Updates

Settings → Updates checks an HTTPS JSON feed. Example: docs/update-feed.example.json.

License

Part Terms
Shell, SDK, plugins, docs, site MIT
Rockstar / GTA marks Not ours. See NOTICE
Third-party APIs Their terms; bring your own credentials

CONTRIBUTING.md · SECURITY.md

About

Desktop phone companion for shortcuts and plugins — https://vty.dev

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages