Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Link-the-Coder/LSTimer

Repository files navigation

LSTimer

A minimal, and fast Rubik’s Cube timer β€” built with Rust.

Install guide

Install guide

Overview


πŸš€ Features

  • βœ… WCA-style inspection and timing
  • 🎯 Scramble generator for multiple events
  • πŸ“Š Detailed session statistics
  • πŸ”— Bluetooth timer support (coming soon)
  • ⚑ Lightweight, terminal-based with low resource usage
  • 🧠 Clean, intuitive UI designed for speed and simplicity

πŸ–ΌοΈ Screenshots

πŸ”§ Settings Panel

Settings

🧩 Multiple Events

Multiple Events

πŸ“ˆ Detailed Stats

Stats


πŸ› οΈ Requirements

  • Git
  • Any functioning OS
  • Rust 1.87 or newer
  • Cargo (Rust package manager)

πŸ“¦ Installation

Mac and linux:

Easy option: go to the Releases tab and install the executable file called LSTimer and run it

Or (more complex, only for linux):

⚠️ Please install packages step-by-step with your correct package manager! If unsure, apt is likely your package manager (Debian/Ubuntu). Otherwise, search online.

# Install Git
sudo pacman -S git # Arch Linux
sudo apt install git # Debian/Ubuntu
# Clone the repository
git clone https://github.com/Link-the-Coder/LSTimer.git ~/LSTimer
cd LSTimer
# Install Cargo
sudo pacman -S cargo # Arch Linux
sudo apt install cargo # Debian/Ubuntu
# Run the app in release mode
cargo run --release

Windows

Go to the Releases tab and install the LSTimer.exe and run it

πŸ’‘ Tip: For faster startup, run the compiled binary directly:

./target/release/LSTimer

πŸ–₯️ Optional: Create Desktop Shortcut

Open or create the desktop entry file:

nano ~/.local/share/applications/LSTimer.desktop

Paste this (replace /home/yourname with your actual username):

[Desktop Entry]
Name=LSTimer
Comment=Launch LSTimer Rust App
Exec=/home/yourname/LSTimer/LSTimer
Terminal=false
Type=Application
Categories=Utility;
StartupNotify=true
Icon=/home/yourname/LSTimer/icon.png

Save and exit. LSTimer should now appear in your app launcher.


🧠 Usage

  • Space: Start / Stop timer
  • Wait for green light before releasing Spacebar
  • Scramble auto-refreshes for each event
  • Escape (Esc): Exit app safely
  • ⚠️ On exit, if the app appears unresponsive, click Terminate

πŸ”’ License

All rights reserved. Source code is viewable but modification, reuse, and redistribution are prohibited.


Made by Link-the-Coder


AltStyle γ«γ‚ˆγ£γ¦ε€‰ζ›γ•γ‚ŒγŸγƒšγƒΌγ‚Έ (->γ‚ͺγƒͺγ‚ΈγƒŠγƒ«) /