Here we describe how to compile, test, run and install KIO FUSE from source.
To install build dependencies on Void Linux:
xbps-install -Sy base-devel fuse3 cmake extra-cmake-modules qt6-base qt6-base-devel kf6-kcoreaddons-devel kf6-kcoreaddons kf6-kio-devel fuse3 fuse3-devel
(and kio-extras for running certain tests)
To install build dependencies on Arch Linux:
pacman -S base-devel fuse3 cmake extra-cmake-modules qt6-base kio
(and kio-extras for running certain tests)
To install build dependencies on Fedora:
dnf install cmake extra-cmake-modules kf6-kio-devel fuse3-devel
qt6-qtbase-devel pkg-config
(and kio-extras for running certain tests)
To install build dependencies on openSUSE Tumbleweed:
zypper install extra-cmake-modules 'cmake(KF6KIO)' 'pkgconfig(fuse3)'
'cmake(Qt6Test)' 'cmake(Qt6Dbus)'
(and kio-extras for running certain tests)
To install build dependencies on Ubuntu:
apt install fuse3 libfuse3-dev build-essential cmake extra-cmake-modules
pkg-config libkf6kio-dev
(and kio-extras for running certain tests)
Once you have installed the build dependencies one can build KIO FUSE itself.
In the root of the git repository run the following:
mkdir build; cd build; cmake .. && make`
In the build directory run the following:
make test
For more verbose output run the following:
make tests ARGS=-V
In the build directory run the following:
make install
This section describes how to start KIO FUSE via DBus activation and by simply running it manually.
KIO FUSE is a DBus activated service, so for permanent installation the
installed service file has to be in a directory used by dbus-daemon.
If you're installing into a custom prefix, you may want to link
[prefix]/share/dbus-1/services/org.kde.KIOFuse.service into
~/.local/share/dbus-1/services/ and
[prefix]/lib/systemd/user/kio-fuse.service into
~/.local/share/systemd/user/.
To make sure that the installed version is actually used, stop any already
running instance with killall kio-fuse and log out and in again.
For quick testing, installation and DBus activation can be skipped. Instead,
after stopping any previously running instance, start the built kio-fuse binary
with the -f parameter and possibly other options.
The DBus service is automatically used by KIO (5.66+) when opening a file on a KIO URL with a KIO-unaware application.
Create a new directory somewhere, make sure that no daemon is going to clean
up after it (like systemd-tmpfiles in /run/user/...) and run kio-fuse -d $dir.
The -d means that it shows debug output and does not daemonize - that makes it
easier to use it at first.
In your session bus you'll find a org.kde.KIOFuse service with an interface that
allows one to communicate with the kio-fuse process.
Let's assume you want to make the files at
ftp://user:password@server/directory accessible in your local file system.
To send the corresponding mount command, you can use our utility script utils/mount-url.sh as follows:
mount-url.sh ftp://user:password@server/directory
Alternatively, you can simply use dbus-send (which is what mount-url.sh uses anyway):
dbus-send --session --print-reply --type=method_call \
--dest=org.kde.KIOFuse \
/org/kde/KIOFuse \
org.kde.KIOFuse.VFS.mountUrl string:ftp://user:password@server/directory
If it failed, KIO FUSE will reply with an appropriate error message. If it
succeeded, you will get the location that the URL is mounted on as a reply. In
this case it would be $dir/ftp/user@server/directory and the directory will be
accessibly at that URL.
After your work is done, simply run fusermount3 -u $dir to unmount the URL and
exit kio-fuse.
Have a lot of fun!