Linux Installation Guide

This guide will walk you through installing Sokuji on Linux systems. Sokuji is available as a .deb package for Debian/Ubuntu-based distributions and as an AppImage for universal compatibility.

Download for Linux

System Requirements

Ubuntu 20.04 or later, Debian 10 or later, or equivalent distribution
64-bit processor
4GB RAM minimum (8GB recommended)
100MB available disk space
PulseAudio or PipeWire for audio support
Internet connection for AI services

Installation Steps

Step 1: Download Sokuji

Visit the official GitHub releases page to download the latest version of Sokuji for Linux.

Available Packages

.deb package - For Debian/Ubuntu based distributions
.AppImage - Universal package for all Linux distributions
.rpm package - For Fedora/RHEL based distributions (if available)

Step 2: Installing .deb Package (Ubuntu/Debian)

If you're using Ubuntu, Debian, or their derivatives, the .deb package is recommended.

Method 1: Using GUI

Open your file manager and navigate to the Downloads folder
Double-click the sokuji_*.deb file
Click "Install" in the Software Center that opens
Enter your password when prompted

Method 2: Using Terminal

Open Terminal and run the following commands:

cd ~/Downloads
sudo dpkg -i sokuji_*.deb

If you encounter dependency issues, fix them with:

sudo apt-get install -f

Step 3: Installing AppImage (Universal)

AppImage works on all Linux distributions and doesn't require installation.

Setup AppImage

Download the AppImage file from the releases page
Make it executable:
```
chmod +x sokuji-*.AppImage
```
Run the application:
```
./sokuji-*.AppImage
```

Optional: System Integration

To integrate the AppImage with your system:

mkdir -p ~/.local/bin
cp sokuji-*.AppImage ~/.local/bin/sokuji
chmod +x ~/.local/bin/sokuji

Now you can run Sokuji from anywhere by typing sokuji in the terminal.

Step 4: First Run Configuration

When you launch Sokuji for the first time, you'll need to configure it:

Initial Setup

Launch Sokuji from your application menu or terminal
Select your preferred interface language
Configure your AI provider (OpenAI, Google Gemini, etc.)
Enter your API key for the selected provider
Select your microphone and speaker devices
Test the audio to ensure everything works

Sokuji is now ready to use! You can start real-time translation by clicking the start session button.

Troubleshooting

Audio Issues

If you experience audio problems:

Ensure PulseAudio or PipeWire is running: systemctl --user status pipewire
Check audio permissions: groups $USER should include 'audio'
Restart audio service: systemctl --user restart pipewire

Permission Denied

If you get "Permission denied" errors:

sudo usermod -a -G audio $USER

Then log out and log back in for the changes to take effect.

Missing Dependencies

Install required libraries:

sudo apt-get update
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 \
    libxtst6 xdg-utils libatspi2.0-0 libdrm2 libgbm1

AppImage Won't Run

If AppImage fails to run, install FUSE:

sudo apt-get install fuse libfuse2

For newer systems (Ubuntu 22.04+), you might need:

sudo apt-get install libfuse2t64