🎯 Quick Start
- Download jMouse.exe from jbeck.app/software
- Run jMouse.exe (click "More info" → "Run anyway" if SmartScreen appears)
- Click "START SERVICE" to begin mouse jiggling
- Minimize to system tray to run in background
✓ No Installation Required: jMouse is a standalone executable. Just run it from anywhere!
💻 System Requirements
- Operating System: Windows 10 or Windows 11 (64-bit)
- Memory: ~50-80 MB RAM during operation
- Disk Space: ~55 MB for executable
- Display: Minimum 1280x720 resolution recommended
- Permissions: No administrator rights required (runs as regular user)
⚙️ Main Features
🖱️ Smart Jiggling
Randomized 45-75 second intervals with variable movement patterns (jitter, orbital, slide) for natural behavior.
💤 Idle Detection
Only jiggles after 30 seconds of inactivity. Won't interfere with your active work.
⏰ Session Limits
Set a specific time to automatically stop the service (e.g., 5:00 PM).
📅 Daily Routines
Configure recurring weekly schedules with different times for each day (Mon-Sun).
⚡ Global Hotkeys
Control jMouse from anywhere with Ctrl+Alt+E (toggle), M (minimize), Q (quit).
🚀 Windows Startup
Automatically launch on Windows boot with optional auto-enable or routine scheduling.
🎮 Basic Controls
Main Window
- START SERVICE - Begin mouse jiggling
- STOP SERVICE - Stop mouse jiggling (shows confirmation if routine is active)
- Apply Session Limit - Enable checkbox and set time to auto-stop
- ⚙️ Advanced Settings - Configure routines, startup, and preferences
Global Hotkeys
- Ctrl + Alt + E - Toggle service on/off
- Ctrl + Alt + M - Minimize to system tray
- Ctrl + Alt + Q - Quit application
System Tray
- Single-click tray icon - Restore window
- Right-click tray icon - Show menu (Restore/Exit)
📅 Setting Up Daily Routines
Step 1: Open Advanced Settings
Click the ⚙️ Advanced Settings button on the main window.
Step 2: Enable Recurring Routine
- Check "Enable Recurring Routine"
- Click "CONFIGURE ROUTINE" button
Step 3: Configure Days & Times
In the Routine Configuration dialog:
- Check the days you want the routine active (Mon-Sun)
- Set start and stop times for each day
- Click "APPLY ROUTINE CHANGES" when done (or Cancel to discard)
Step 4: Save Settings
Click "APPLY CHANGES" in Advanced Settings to save your routine.
💡 Example Routine:
Monday-Friday: 9:00 AM - 5:00 PM
Weekend: Disabled
jMouse will automatically start at 9 AM and stop at 5 PM on weekdays, without any manual intervention!
Manual Override
Even with a routine active, you can:
- Manually start outside scheduled hours (use START SERVICE button)
- Manually stop during scheduled hours (shows pause confirmation)
- Session limits take priority over routines
⚠️ Pause Behavior: If you manually stop the service during routine hours, it will pause for the rest of the day. The routine will resume automatically the next day during scheduled hours.
🚀 Windows Startup Options
In Advanced Settings, you can configure three startup modes:
1. Open jMouse Only
App launches on Windows startup but service stays off. You manually start it when needed.
2. Open and Auto-Enable
App launches on startup AND automatically starts the service (no session limit).
3. Use Routine Schedule
App launches on startup and follows your configured daily routine. Starts/stops automatically based on your schedule.
💡 Recommended: If you have a consistent work schedule, use Routine Schedule mode. Set it up once and forget about it!
⏰ Session Limits vs Routines
| Feature |
Session Limit |
Daily Routine |
| Purpose |
One-time auto-stop |
Recurring schedule |
| Configuration |
Checkbox + time picker on main window |
Advanced Settings → Configure Routine |
| Auto-Start |
No (manual only) |
Yes (at scheduled times) |
| Auto-Stop |
Yes (at specified time) |
Yes (at scheduled end time) |
| Priority |
Higher |
Lower |
💡 Priority Rule: Session limits always take priority. If you have a routine AND a session limit, the session limit will stop the service even if the routine is still active.
🎨 Status Indicators
- 🔴 SYSTEM IDLE (Red) - Service is stopped
- 🟢 SERVICE ACTIVE (Green) - Service is running and jiggling
- 🟡 USER ACTIVE (Gold) - You're using the computer, waiting to resume jiggling
- 🟡 MOVING... (Gold) - Currently executing a jiggle movement
🔧 Troubleshooting
Icon Not Appearing
The icon should be bundled in jMouse.exe. If icons are missing on dialogs, ensure you're using v2.0.0 which has improved icon loading.
SmartScreen Warning
This is normal for unsigned executables. Click "More info" → "Run anyway". The app is safe!
Hotkeys Not Working
Some apps (games, other utilities) might capture hotkeys first. Try closing other apps.
Routine Not Starting Automatically
Check:
- Is "Enable Recurring Routine" checked in Advanced Settings?
- Did you click "APPLY CHANGES" to save?
- Is the current time within your scheduled hours?
- Did you manually stop the service today? (Creates a kill block until midnight)
Service Stops Unexpectedly
Possible causes:
- Session limit reached
- Routine schedule ended
- App was closed or crashed
💾 Settings & Data
Settings File
Stored in: jmouse_settings.json (same folder as jMouse.exe)
Contains:
- Routine schedules
- Startup preferences
- Minimize behavior
Windows Registry
If startup is enabled, jMouse writes to:
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
This is user-level only (no admin required) and can be disabled anytime in Advanced Settings.
🔐 Privacy & Security
- No network access: jMouse never connects to the internet
- No data collection: Nothing is logged, recorded, or transmitted
- Local only: All activity stays on your machine
- Input monitoring: Used only for idle detection and hotkeys (not recorded)
⚖️ Responsible Use
⚠️ Important: jMouse is a tool that can be misused. You are responsible for:
- Ensuring compliance with your employer's policies
- Not misrepresenting your work status or availability
- Understanding the risks of automated activity tools
See the Terms & Conditions for full details.
❓ Need More Help?
jMouse v2.0.0 • Built by jbeck.app • Use responsibly