Skip to content

mariinkys/clockode

Repository files navigation


Clockode

Flathub Version GitHub License GitHub Repo stars

TOTP client made with Iced

Main Page (Light Mode) Main Page (Dark Mode)



Download on Flathub

Notes

Key features are:

  • Storage for all your 2FA and OTP tokens with automatic TOTP code generation
  • Data is encrypted on your device using battle-tested software libraries
  • Entry importing via QR (Camera or File)
  • Minimal and user-friendly interface
  • Quick code copying and auto-refresh
  • Backup and import functionality (standard format that works between apps like Aegis...)

If you want to sync your vault you will have to do it yourself using tools like Syncthing...

Warning

As with any app that manages important data, please ensure you back up your data offsite regularly.

Installation

Linux

You can download the Flatpak on Flathub.

Or you can use just to install the package:

git clone https://github.com/mariinkys/clockode.git
cd clockode
cargo build --release
sudo just install

Attributions

"Pop Icons" by System76 is licensed under CC-SA-4.0

Application Icon from SVGRepo made by Tolu Arowoselu (colors modified by myself).

Development Notes

In order to build the Flatpak, first you need to create the 'cargo-sources.json' file, for that we'll use this python script, from flatpak-builder-tools, remember that the 'tomlkit' and 'aiohttp' python modules are needed (they can be installed with pip).

Once you have that, with the python script in the root of the project, you can start with:

python3 flatpak-cargo-generator.py Cargo.lock -o cargo-sources.json

This will create the needed 'cargo-sources.json' file. Then you already can build and install the Flatpak with:

flatpak-builder --user --install --force-clean build-dir dev.mariinkys.Clockode.yaml

You can also build the Flatpak and not install it with:

flatpak-builder --force-clean build-dir dev.mariinkys.Clockode.yaml

Useful resources include: Flatpak Docs. Remember that whenever the dependencies change/are updated the 'cargo-sources.json' file needs to be rebuilt.

Dependencies

All of iced dependencies and

  • GStreamer 1.0 with plugins (base, good, bad, ugly)

About me

Check out my other projects

You can also help do this and more projects, Buy me a coffee

Copyright and Licensing

Copyright 2025 © Alex Marín

Released under the terms of the GPL-3.0