↓Skip to main content
  1. User Guide/

Install LibreCelik

LibreCelik is a desktop application for reading and displaying smart card data on Linux and macOS. It supports a growing range of card types through its plugin architecture.

Linux #

Download the .AppImage from the releases page, make it executable, and run it:

chmod +x LibreCelik-*.AppImage
./LibreCelik-*.AppImage

No installation required. The AppImage bundles all dependencies including Qt.

PC/SC reader support #

The pcscd daemon must be running for card access:

# Debian/Ubuntu
sudo apt install pcscd pcsc-tools
sudo systemctl enable --now pcscd

# Fedora/RHEL
sudo dnf install pcsc-lite pcsc-tools
sudo systemctl enable --now pcscd

# Arch/Manjaro
sudo pacman -S ccid pcsc-tools
sudo systemctl enable --now pcscd

Verify your card reader is detected:

pcsc_scan

macOS #

Download and open the .dmg from the releases page, drag LibreCelik to Applications.

macOS includes PC/SC support natively — no extra software needed.

Requirements #

  • A USB smart card reader (contact or contactless, depending on the card)
  • Linux: pcscd daemon running
  • macOS: no additional requirements

Building from source #

See the Developer Guide — Building From Source for full build instructions.