TikTok

Minimal GTK4 stopwatch for XFCE and other Linux desktops.
Tracks time with centisecond precision. Lives in your taskbar, stays out of your way.

Keybinds

Key	Action
Space	Start / Stop
Shift+C	Reset

---

Install a release (no compiler needed)

Download the latest tarball from the Releases page.

tar -xzf tiktok-*-linux-x86_64.tar.gz
cd tiktok-*-linux-x86_64
sudo ./install.sh

To remove it:

sudo rm /usr/local/bin/tiktok
sudo rm /usr/local/share/applications/tiktok.desktop
sudo rm /usr/local/share/icons/hicolor/scalable/apps/tiktok.svg

---

Build from source

Dependencies

Debian / Ubuntu / Mint / Pop!_OS

sudo apt install build-essential pkg-config libgtk-4-dev

Fedora / RHEL

sudo dnf install gcc make pkg-config gtk4-devel

Arch

sudo pacman -S base-devel pkg-config gtk4

Build and install

git clone https://github.com/grgorien/tiktok
cd tiktok
make release
sudo make install

Verify it worked:

tiktok --version

Uninstall

sudo make uninstall

---

Development

make          # debug build with -g -O0 (runs as ./tiktok)
make debug    # same as above, explicit
make release  # optimised build with -O2 (runs as ./tiktok)
make clean    # remove build artefacts

The default make produces a debug binary in the project directory, nothing is installed to your system. Use sudo make install when you want the binary available system-wide.

GTK4 is required. This will not build or run on GTK3.