A free C++ BitTorrent/HTTP/FTP Download Client

This is an old revision of the document!

BitComet Installation Guide for Linux

BitComet Linux Edition is packaged using AppImage format, which can run the application without needing superuser permissions to install it. The detailed info about AppImage format can be found at https://www.appimage.org/

Step 1 Check Linux Distro Version (optional)

Linux Distro	Supported Version
Ubuntu	18.04
Debian	12.1
Fedora	38
openSUSE	Leap 15.5 / Tumbleweed
CentOS	Stream 9
Others	GLIBCXX_3.4.22 or higher

The only requirement to run BitComet in your Linux distro is the GLIBCXX version in libstdc++.so.
BitComet cannot run if the GLIBCXX version in your Linux distro is lower than GLIBCXX_3.4.26

The version of installed GLIBCXX in your Linux distro can be find by following commands:

 # find libstdc++.so.6 file
 find /usr/ -name libstdc++.so.6

 # get GLIBCXX version, typically using
 strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX

 # or using
 strings /usr/lib64/libstdc++.so.6 | grep GLIBCXX

Step 2 Download BitComet

The AppImage file of BitComet Linux edition can be downloaded from the official website.

Step 3 Make AppImage executable and run it

Using the GUI

Open your file manager and browse to the location of the AppImage
Right-click on the AppImage and click the ‘Properties’ entry
Switch to the Permissions tab and click the ‘Allow executing file as program’ checkbox
Close the dialog
Double-click on the AppImage file to run

Using the Terminal

Open a terminal
Change to the directory containing the AppImage, e.g., using
```
 cd <my directory> 
```
Make the AppImage executable:
```
chmod +x BitComet.AppImage
```
Run the AppImage:
```
./BitComet.AppImage
```

Step 4 Install missing libraries if failed to run AppImage (distro-specific)

If your Linux distro doesn't contain some necessary libraries that BitComet depends on, please try to install them manually.

Open a terminal
Change to the directory containing the AppImage, e.g., using
```
 cd <my directory> 
```
Try to run the AppImage again:
```
./BitComet.AppImage
```
Install the missing libraries based on the error message:

For Ubuntu / Debian distros

Library	commands to check installed version and install missing library
libfuse2	apt list \| grep libfuse sudo apt install libfuse2
libwebkit2gtk-4.0	apt list \| grep libwebkit2gtk sudo apt install libwebkit2gtk-4.0-37

For Fedora / RedHat / CentOS distros

Library	commands to check installed version and install missing library
libfuse2	yum list fuse* sudo yum –enablerepo=epel install fuse-sshfs sudo usermod -a -G fuse $(whoami)
libwebkit2gtk-4.0	yum list webkit2gtk* sudo yum install webkit2gtk-4.0.x86_64

For openSUSE distros

Library	commands to check installed version and install missing library
libfuse2	zypper search -i libfuse sudo zypper install fuse libfuse2
libwebkit2gtk-4.0	zypper search -i webkit2gtk sudo zypper install webkit2gtk-4_0-37

More info about errors related to something called “FUSE” can be found at this page