Install and start a session

Getting started with Lofitime

Install Lofitime, choose something to work on, and start a focus timer. Add a lo-fi station if you want music alongside your session; the timer works without it too.

Download and install on your Mac

Lofitime requires macOS 14 or later and supports both Apple Silicon and Intel Macs. Published releases are signed and notarized. You do not need developer tools to install a release.

  1. Open the Lofitime download link and download the release DMG.
  2. Open the DMG and drag Lofitime.app into Applications.
  3. Launch Lofitime from Applications. Click its icon in the Mac menu bar to open the timer and music controls.

The release notes list changes. Automatic updates download in the background and install when you quit. You can also check for updates in Settings.

Start your first focus session

Pick a specific task before starting: read a chapter, draft a section, review a set of notes, or work through one problem. A timer is most useful when the next step is clear.

  1. Choose a station and press Play music if you want background radio. Chill house is the default; Study lo-fi, Sleepy lo-fi, and Synthwave are also available.
  2. Press Start focus to begin your timer.
  3. Work on your chosen task until the interval ends, then take a break before another focus session.

You can start a timer without playing music, or play music without starting a timer. Radio playback requires an internet connection because it uses YouTube livestreams. See the lo-fi music guide for playback details.

Lofitime starts in the menu bar, with no main window or Dock icon. The popup has a house button to show your room and a headphones button to return to the music and timer.

Open Lofitime, Stats, and Settings are at the bottom of either popup view. They open the larger window on the selected page. The Dock icon appears while that window is open, including when minimized. Closing it removes the Dock icon and keeps the timer and music running.

To quit completely, choose Quit Lofitime in the popup’s menu, or use ⌘ Q while the app is active.

Adjust your timer and preferences

Open Settings from the popup or with ⌘ , while using the app. Change timer defaults, enable launch at login, or choose automatic breaks. The six themes are Candlelight, Catppuccin, Moss, Moonlight, Rosewood, and Tokyo Night.

For a one-off duration, edit a paused countdown. Enter 45 for 45 minutes or 25:30 for 25 minutes and 30 seconds. The Pomodoro timer guide explains how to build a focus-and-break routine around these controls.

Open Stats to see daily sessions, weekly bars, monthly totals, and all-time focus. Completed sessions also grow your room. History stays saved when the room gets quieter.

Sync history across Macs

Sync is optional. It uses your GitHub CLI login and a private GitHub repository for completed session times, durations, and intentions.

  1. Install GitHub CLI on each Mac, then sign in with gh auth login --hostname github.com --web --scopes repo.
  2. On the first Mac, open Settings → Sync across Macs → Create a new sync. Choose a repository name and press Create private sync.
  3. Choose Copy repository link. On the other Mac, choose Connect to sync, paste the link, and connect. Both Macs need write access to the repository.

Completed sessions merge automatically at launch, when you return to the app, after a completed session, and every five minutes. Offline sessions stay saved and sync later. Your active timer, music, and settings stay separate on each Mac. Disconnecting keeps both local history and the repository.

Keyboard shortcuts

Lofitime app shortcuts
ShortcutAction
⌘ ReturnStart, pause, or resume the timer
⌘ ⇧ PPlay or pause music
⌘ ⇧ RReset the current session
⌘ 1Open your room
⌘ 2Open Stats
⌘ ,Open settings
⌘ QQuit Lofitime

These shortcuts work while Lofitime is active. In the room, scroll or pinch to zoom, drag to move, Option-drag or right-drag to tilt, and double-click to reset the view.