Skip to main content

Two claps → JARVIS speaks → launches your workspace

Project description

JARVIS Launcher

Clap twice → JARVIS speaks → your workspace opens automatically.

Detects two consecutive claps via microphone and launches Claude Code, Cursor, and a YouTube song of your choice. Runs as a background app with a system tray icon on Linux, macOS, and Windows.

Install

pip install jarvis-launcher
jarvis-launcher

No system dependencies required on any platform.

Download binary (no Python needed)

Grab the latest binary from Releases.

Platform File
Linux jarvis-launcher-linux
macOS jarvis-launcher-macos
Windows jarvis-launcher-windows.exe

Usage

Start the app

jarvis-launcher

A green tray icon appears. The terminal shows mic levels in real-time:

[████████░░░░░░░░░] 🔔🔔
  • Green icon = listening
  • Yellow icon = sound detected
  • Red icon = triggered
  • Gray icon = paused

Right-click the tray icon to pause/resume, open settings, or quit.

CLI commands

jarvis config          # Show current configuration
jarvis set sensitivity 0.2  # Change a setting
jarvis voices          # List available TTS voices
jarvis open-settings   # Open config in editor
jarvis test-mic        # Test microphone levels

Configuration

Settings live in ~/.jarvis-launcher/config.json (created on first run). Open it via the tray menu or edit directly:

{
  "sensitivity": 0.15,
  "required_claps": 2,
  "open_claude_code": true,
  "open_cursor": true,
  "open_youtube": true,
  "youtube_url": "https://www.youtube.com/watch?v=v2AC41dglnM",
  "voice": "en-GB-RyanNeural"
}

Sensitivity tuning:

Value Environment
0.08 Very quiet room
0.15 Normal office (default)
0.25 Noisy environment

Changes take effect on the next clap trigger — no restart needed.

How it works

  • Streams microphone audio in 1024-sample chunks at 44100 Hz
  • Each chunk is checked for clap signature: high RMS + energy concentrated in the 1–8 kHz band (>25% of total)
  • Adaptive threshold adjusts to background noise automatically
  • Two claps within 3 seconds trigger the launch sequence

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jarvis_launcher-1.2.0.tar.gz (23.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jarvis_launcher-1.2.0-py3-none-any.whl (12.7 kB view details)

Uploaded Python 3

File details

Details for the file jarvis_launcher-1.2.0.tar.gz.

File metadata

  • Download URL: jarvis_launcher-1.2.0.tar.gz
  • Upload date:
  • Size: 23.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for jarvis_launcher-1.2.0.tar.gz
Algorithm Hash digest
SHA256 4abaedc1a456732f51fd11040b12e334937dac02ed525690676c409fa878e724
MD5 40eac105039d2323d3b6a4f080bd8afc
BLAKE2b-256 170cbcf82f24293664db14e9811433f89c784a8ab492fbad8197ccb2c9859996

See more details on using hashes here.

Provenance

The following attestation bundles were made for jarvis_launcher-1.2.0.tar.gz:

Publisher: publish.yml on francogalfre/jarvis-launcher

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file jarvis_launcher-1.2.0-py3-none-any.whl.

File metadata

  • Download URL: jarvis_launcher-1.2.0-py3-none-any.whl
  • Upload date:
  • Size: 12.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for jarvis_launcher-1.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ff0a34c82a379c199fc87ccba5041088186c0d83fad8ab165932c7ba384c2876
MD5 b9a15b6ce5bd85a6c7236b844598e348
BLAKE2b-256 3cc9b2c17a87974393c06bd1d9641f8c464e3ddc2a818d7acb23bfc377a09163

See more details on using hashes here.

Provenance

The following attestation bundles were made for jarvis_launcher-1.2.0-py3-none-any.whl:

Publisher: publish.yml on francogalfre/jarvis-launcher

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page