Skip to content

manuroe/rageshake-viewer

Repository files navigation

Rageshake Viewer

codecov

A web viewer for rageshake logs produced by the Matrix Rust SDK and Element X apps (Android, iOS). All processing runs locally in your browser — no data is sent anywhere.

Live at https://manuroe.github.io/rageshake-viewer/

Summary view Summary view

Logs view Logs view

Sync waterfall Sync waterfall

Demo mode

Click "Try with demo logs" on the landing page to explore the app without a real log file.

Run locally

npm install
npm start

Open http://localhost:5173

Browser extension

The extension enhances listing pages of any rageshake server deployment by redirecting /api/listing/* pages into the bundled viewer and rendering them with the same archive-style screen used by the web app. It auto-detects rageshake archive pages using the standard /api/listing/* path — no configuration needed.

Without extension With extension
Rageshake listing page without extension Rageshake listing page without extension Rageshake listing page enhanced by extension Rageshake listing page enhanced by extension

Note: The extension is not yet published on the Chrome Web Store or Firefox Add-ons. It must be installed manually as an unpacked/temporary extension.

Install

Chrome / Edge

npm run build:extension

Output is written to extension-dist/.

  1. Go to chrome://extensions (or edge://extensions).
  2. Enable Developer mode (toggle, top-right).
  3. Click Load unpacked and select the extension-dist/ folder.

To pick up changes: run npm run build:extension, then click the ↺ refresh icon on the extension card.

Firefox — temporary (session only)

extension-dist/ uses a Chrome-format manifest that Firefox does not support. Build the Firefox-specific bundle first:

npm run build:extension:firefox

Then:

  1. Go to about:debugging#/runtime/this-firefox.
  2. Click Load Temporary Add-on… and select extension-dist-firefox/manifest.json.

To pick up changes: re-run npm run build:extension:firefox, click Reload next to the extension, then reload the rageshakes tab (Cmd+R).

The extension is removed when Firefox closes.

Firefox — persistent (via web-ext)

npm run webext:run

This builds the Firefox bundle and launches a dedicated Firefox profile with the extension pre-loaded. Preferred for active development.

Usage

Navigate to any rageshake listing URL (e.g. https://<your-rageshake-server>/api/listing/<id>/). The content script runs automatically and opens the bundled archive-style viewer for that listing, including per-file summaries, details.json metadata, and screenshot thumbnails when present.

Contributing

See AGENTS.MD for architecture notes and agent/contributor guidance.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages