Skip to content

Repository files navigation

⏱️ ZTimer

A professional-grade Rubik's Cube speedsolving timer — pure frontend, no backend required.

Live Demo License HTML


✨ Features

  • 🎯 WCA Inspection Timer — Official 15-second inspection countdown with penalty support (+2 / DNF)
  • 🔀 Scramble Generator — Instant scramble generation for all major cube types
  • 📊 Statistics & Charts — Time progression, Ao5, Ao12, distribution charts
  • 💾 Local Storage — All data saved in your browser, no account needed
  • 🌍 6 Languages — English, 繁體中文, Español, Français, 日本語, 한국어
  • 🎨 Themes — Multiple dark themes
  • 🔔 Sound Effects — Web Audio API beep sounds
  • 📱 Responsive — Works on desktop and mobile

🧊 Supported Cube Types

Puzzle Label
3×3×3 333
2×2×2 222
4×4×4 444
5×5×5 555
6×6×6 666
7×7×7 777
3×3 One-Handed 333oh
3×3 Blindfolded 333bld
Clock clock
Megaminx minx
Pyraminx pyram
Skewb skewb
Square-1 sq1

🚀 Quick Start

Option 1 — Use Online

Just visit: https://ztimer.zcompany.us

Option 2 — Run Locally

git clone https://github.com/Victus0660/ZTimer.git
cd ZTimer
# Open index.html in your browser — no server needed!
open index.html        # macOS
start index.html       # Windows
xdg-open index.html    # Linux

🛡️ Privacy & Security

  • 100% client-side — no server, no database, no API calls
  • No tracking — your solve times never leave your device
  • Data is stored only in your browser's localStorage
  • Safe to self-host on any static file hosting (GitHub Pages, Netlify, Cloudflare Pages, etc.)

📁 Project Structure

ZTimer/
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── feature_request.md
│   └── PULL_REQUEST_TEMPLATE.md
├── index.html        # Entire app (single-file)
├── V.png             # App icon / logo
├── sitemap.xml       # SEO sitemap
├── robots.txt        # Crawler directives
├── CONTRIBUTING.md   # Contribution guidelines
├── SECURITY.md       # Security policy
├── CHANGELOG.md      # Release changelog
├── LICENSE           # AGPL-3.0
└── README.md         # This file

🌐 Deploy to GitHub Pages

  1. Fork or push this repo to GitHub
  2. Go to Settings → Pages
  3. Source: Deploy from a branchmain/ (root)
  4. Save — your site will be live and you can map your custom domain (e.g. ztimer.zcompany.us) in the Pages settings.

📄 License

AGPL-3.0 License — feel free to fork, modify, and share. See LICENSE for details.


Made with ❤️ for the speedcubing community

About

A professional frontend-only Rubik's Cube & speedsolving timer. Features WCA inspection, scrambles, and stats. Hosted at ztimer.zcompany.us

Topics

Resources

Contributing

Security policy

Stars

52 stars

Watchers

6 watching

Forks

Releases

Packages

Contributors

Languages