Tally - Linux Build Instructions

Prerequisites

Before building Tally on Linux, you'll need to install the following:

1. Node.js (v18 or later)

                # Ubuntu/Debian:
                
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
                
sudo apt-get install -y nodejs
                
# Fedora:
                
sudo dnf install nodejs npm

2. Rust Toolchain

                # Install Rust from https://rustup.rs/
                
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
                
source ~/.cargo/env

3. System Dependencies

                # Ubuntu/Debian:
                
sudo apt update
                
sudo apt install build-essential libgtk-3-dev libwebkit2gtk-4.0-dev libappindicator3-dev librsvg2-dev patchelf
                
# Fedora:
                
sudo dnf install gtk3-devel webkit2gtk3-devel libappindicator-gtk3-devel librsvg2-devel patchelf

4. Git

                # Ubuntu/Debian:
                
sudo apt install git
                
# Fedora:
                
sudo dnf install git

Build Steps

1. Clone the Repository

                git clone https://github.com/abdulrahmanqureshi/time2trace.git
                
cd time2trace/timetrace-mock

2. Install Dependencies

npm install

3. Build the Application

npm run tauri:build

4. Find the AppImage

                # The AppImage will be created at:
                
src-tauri/target/release/bundle/appimage/Tally_*.AppImage
                
# Make it executable:
                
chmod +x src-tauri/target/release/bundle/appimage/Tally_*.AppImage

Running the AppImage

1. Make Executable

chmod +x Tally_*.AppImage

2. Run the Application

./Tally_*.AppImage

3. Optional: Install System-Wide

                # Copy to /usr/local/bin for system-wide access
                
sudo cp Tally_*.AppImage /usr/local/bin/tally
                
sudo chmod +x /usr/local/bin/tally
                
# Now you can run it from anywhere:
                
tally

Troubleshooting

⚠️ Common Issues

GTK/WebKit errors: Make sure you have all the required system dependencies installed.

Permission errors: Ensure the AppImage is executable with chmod +x.

Rust compilation errors: Make sure you have the latest Rust toolchain installed.

Alternative: Use Snap/Flatpak

If building from source is challenging, you can use package managers:

                # Snap (if available):
                
sudo snap install tally
                
# Flatpak (if available):
                
flatpak install flathub com.abdulrahmanqureshi.timetrace

Need Help?

If you encounter issues building Tally on Linux:

Check the GitHub Issues page
Join our community discussions
Check your distribution's package manager for pre-built packages

← Back to Download Page View on GitHub

🐧 Linux Build Instructions