Virtual touchpad, cursor, fullscreen toggle, and Eruda DevTools for Firefox on Android
- TypeScript 84.4%
- HTML 9.2%
- CSS 5.9%
- Nix 0.5%
|
All checks were successful
Build & Test Extension / Build, Test & Package (push) Successful in 11s
|
||
|---|---|---|
| .forgejo/workflows | ||
| src | ||
| tests | ||
| .envrc | ||
| .gitignore | ||
| build.ts | ||
| bun.lock | ||
| flake.lock | ||
| flake.nix | ||
| LICENSE | ||
| package.json | ||
| README.md | ||
| serve.ts | ||
| tsconfig.json | ||
Mobile Tweaks
A WebExtension for Firefox on Android providing an on-screen touchpad, virtual mouse cursor, fullscreen toggle, and integrated Eruda developer tools.
Repository: https://git.ruject.fun/RuJect/ext-mobile-tweaks
Features
Touchpad & Virtual Cursor
- Corner Dragging: Reposition the touchpad across the screen using four corner handles without interfering with the cursor surface.
- Cursor Control: Single-finger swipes translate to pointer motion with configurable sensitivity and acceleration profiles (
none,low,medium,high). - Mouse Buttons: Dedicated Left, Middle, and Right mouse buttons with drag-and-drop and text selection support.
- Two-Finger Scrolling: Multi-touch vertical and horizontal viewport scrolling with optional direction inversion.
- Tap to Click: Optional single-tap action mapped to primary mouse click.
- Shadow DOM Isolation: All UI elements are rendered inside a single isolated shadow root on
document.documentElementto prevent style leakage and stacking context clipping.
Tools
- Fullscreen Toggle: Fixed top-right floating button to toggle
requestFullscreenandexitFullscreen. Automatically adopts into active fullscreen elements. - Eruda DevTools: Mobile developer console providing DOM inspection, network monitoring, storage view, and console logging.
Customization & Localization
- Live settings synchronization via
browser.storage. - Configurable opacity, dimensions, and styling for both cursor and touchpad.
- Bilingual interface (English and Russian).
Tech Stack
- Runtime & Bundler: Bun
- Language: TypeScript 5.x
- Standard: WebExtensions Manifest V3 (Gecko)
- CI/CD: Forgejo Actions
Development
Prerequisites
- Bun 1.x
Commands
# Install dependencies
bun install
# Build unpacked extension to dist/
bun run build
# Watch mode for development
bun run watch
# Typecheck
bun run typecheck
# Run unit tests
bun test
# Package .zip and .xpi artifacts
bun run package
# Serve .xpi locally on port 3333
bun run serve
Installation on Firefox for Android
- Build the distribution package:
bun run package - In Firefox Nightly on Android:
- Navigate to Settings -> About Firefox Nightly.
- Tap the Firefox logo 5 times to unlock Developer options.
- Return to Settings -> Developer options (or Add-ons).
- Select Install add-on from file and choose
mobile-tweaks.xpi.
Alternatively, deploy directly via web-ext:
npx web-ext run --target=firefox-android --firefox-apk=org.mozilla.fenix
Authors
- rus07tam (rus07tam+contact@ruject.fun)
License
This is free and unencumbered software released into the public domain. See LICENSE for details.