Skip to content

Latest commit

 

History

28 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ratio

Create more. Consume less.

Ratio is a macOS menu-bar app that measures time in the active app or browser site, then lets you classify that time as creating or consuming. It shows the balance in the menu bar and keeps a local daily history.

Get Ratio

  • Signed app: Buy the notarized, automatically updating build for $20 at ratio.visualizevalue.com.
  • Build it yourself: Clone this repository and follow the instructions below.

The paid build funds development and removes the work of compiling, signing, notarizing, and updating the app. The application source is available under GPL-3.0.

What it records

  • Ratio counts time only for the foreground window.
  • For supported browsers, it can read the active tab and retains only the hostname.
  • App usage, classifications, daily history, and preferences stay in macOS UserDefaults on your Mac.
  • Update authentication is stored in Keychain.
  • The signed build can share one anonymous cumulative tracked-time total. It never sends app names, site names, window titles, classifications, or daily history. This is enabled by default and can be disabled from Share Anonymous Total in the right-click menu. Self-built copies do not report unless they have a valid purchaser update credential.

See native/Sources/main.swift for the complete implementation.

Requirements

  • macOS 12 or newer
  • Intel or Apple silicon
  • Xcode command-line tools

Build the Mac app

git clone https://github.com/visualizevalue/ratio.git
cd ratio/native
./setup-sparkle.sh
./build.sh
open Ratio.app

build.sh creates a universal Intel/Apple-silicon app, applies an ad-hoc local signature, and runs the accounting self-tests. An ad-hoc build may require right-clicking the app and choosing Open. It does not carry Visualize Value's Developer ID signature or Apple notarization.

Automatic updates for the distributed build use Sparkle. Update downloads require a verified Ratio purchase; this does not prevent local builds or modify local tracking data.

Contributing

Issues and focused pull requests are welcome. Please keep the interface compact, preserve local-first tracking, and do not add collection of app names, sites, window titles, or browsing history.

License

Ratio's application source is licensed under GNU GPL v3. The Ratio name, icon, and Visualize Value name are trademarks or brand assets and are not granted for use by the GPL software license. Third-party components retain their own licenses.

About

Ratio: create more, consume less — an open-source macOS menu-bar time tracker

Topics

Resources

Security policy

Stars

31 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages