Docs / Reference

Desktop App Reference

The keibidrop application: screens, controls, and settings.

Screens

The app has four screens. Which connected screen you see depends on the FUSE driver:

ScreenWhen
ConnectNot connected. Pairing, discovery, and contacts.
Connected: direct transferConnected without a FUSE driver, or with FUSE off. File cards.
Connected: shared folderConnected with the FUSE mount active. "Shared folder is live".
Saved FilesBrowser for files you downloaded.

Settings are read from the same config file as the CLIs. One engine runs under all three interfaces.

Connect screen

Header: "Connect Securely - Exchange fingerprints to establish a secure connection".

ControlFunction
Peer code fieldPaste the code your peer sent you. A valid code shows "Peer code added". An invalid one shows "Invalid code. Check that you copied the full code from your peer."
Connect buttonStarts the connection. Both peers press Connect. Cancel stops the attempt.
LAN toggle"Same WiFi? Toggle to find your peer automatically." Shows your session name ("You appear as: ...") and a list of nearby devices, each with its own Connect button.
Contacts listSaved peers with a Connect button and an X to remove. Online contacts connect with one click.
FUSE toggleChooses the shared-folder mode. Disabled when no FUSE driver is installed; a hint shows the install source for your OS.
Incognito toggleEphemeral identity for this session. Nothing is written to disk.

Connected: direct transfer

Shown when there is no active mount. Drag files into the window to send them. Each file is a card with a progress bar.

ControlFunction
Mode badgeShows the network path: LAN, direct, or bridge.
Save PeerSave the connected peer as a contact.
Save AllDownload every offered file to the save path.
< BackReturn to the Connect screen.

Connected: shared folder

Shown when the FUSE mount is active. Header: "Connected · FUSE mounted" and "Shared folder is live".

The screen states the two rules of the mode: drop files into the folder to share them, and files stream on access, so you can open videos, documents, or code without waiting for a full download.

ControlFunction
Mount pathWhere the shared folder lives. See Files and folders.
Open FolderOpens the mount in Finder or Explorer.
Save PeerSave the connected peer as a contact.

Saved Files browser

Lists files you downloaded to the save path. Open Folder opens the save path. The empty state reads "No saved files - Files you download will appear here".

Global controls

ControlFunction
DisconnectEnds the session. If a download is in progress, it asks you to press Disconnect again to confirm.
Saved FilesOpens the Saved Files browser.
Save LogExports a sanitized log file. See Collect logs and report a problem.
⚙ (settings)Opens the settings panel.
? (help)Shows a short how-to and a link to keibidrop.com.
X (exit)Unmounts the folder, disconnects, and quits.

Settings panel

The panel displays the active configuration. It does not edit it. The one control is the "Encrypt identity with a passphrase" toggle.

FieldShows
Relay serverThe relay URL in use.
Save path (received files)Where downloads land.
Mount path (FUSE virtual folder)Where the shared folder mounts.
Log fileThe active log path.
Config fileThe config file path.
VersionApp version and commit hash.

To change a value, edit the config file and restart the app. The panel states this rule:

Edit ~/.config/keibidrop/config.toml to change settings. Restart to apply.

All keys are documented in the configuration reference. Source: rust/src/ui.slint.