Virtual touchpad, cursor, fullscreen toggle, and Eruda DevTools for Firefox on Android
  • TypeScript 84.4%
  • HTML 9.2%
  • CSS 5.9%
  • Nix 0.5%
Find a file
rus07tam fdf8dbcc8d
All checks were successful
Build & Test Extension / Build, Test & Package (push) Successful in 11s
fix(build): use pure TypeScript zip archiver instead of external python3
2026-10-06 01:04:15 +03:00
.forgejo/workflows ci: split artifacts into mobile-tweaks-xpi and mobile-tweaks-zip 2026-10-06 01:01:29 +03:00
src initial commit 2026-10-06 00:52:41 +03:00
tests initial commit 2026-10-06 00:52:41 +03:00
.envrc initial commit 2026-10-06 00:52:41 +03:00
.gitignore initial commit 2026-10-06 00:52:41 +03:00
build.ts fix(build): use pure TypeScript zip archiver instead of external python3 2026-10-06 01:04:15 +03:00
bun.lock fix(ci): update bun.lock to resolve frozen lockfile error 2026-10-06 00:55:14 +03:00
flake.lock initial commit 2026-10-06 00:52:41 +03:00
flake.nix initial commit 2026-10-06 00:52:41 +03:00
LICENSE initial commit 2026-10-06 00:52:41 +03:00
package.json initial commit 2026-10-06 00:52:41 +03:00
README.md initial commit 2026-10-06 00:52:41 +03:00
serve.ts initial commit 2026-10-06 00:52:41 +03:00
tsconfig.json initial commit 2026-10-06 00:52:41 +03:00

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.documentElement to prevent style leakage and stacking context clipping.

Tools

  • Fullscreen Toggle: Fixed top-right floating button to toggle requestFullscreen and exitFullscreen. 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

  1. Build the distribution package:
    bun run package
    
  2. 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

License

This is free and unencumbered software released into the public domain. See LICENSE for details.