TUI Guide
Launch with pikpaktui (no arguments). On first run a login form appears. After login, you're in the responsive file browser. Press h for the built-in help sheet, ? for the discoverable Actions menu, or , for settings.
File Browser
The main view adapts to the terminal width:
- 96 columns or wider — parent, current directory, and preview
- 64–95 columns — current directory and preview
- Narrower than 64 columns — current directory only
When the preview is disabled, the browser uses parent + current panes at 60 columns or wider and a single current-directory pane below that.
| Key | Action |
|---|---|
j / k / ↑ / ↓ | Navigate up/down |
g / Home | Jump to top |
G / End | Jump to bottom |
PageUp / PageDown | Page scroll |
Ctrl+U / Ctrl+D | Half-page scroll |
Enter | Open folder / play video (auto-opens quality picker) |
Backspace | Go to parent directory |
w | Stream video — opens quality/resolution picker |
r | Refresh current directory |
m | Move (opens folder picker or text input, per move_mode setting) |
c | Copy |
n | Rename (opens inline text input) |
d | Delete — prompts for confirmation |
f | New folder (opens inline text input) |
s | Star / unstar current file |
y | Copy direct download URL to clipboard (files only) |
u | Upload a local file to the current folder |
a | Toggle current item in/out of cart |
S | Cycle sort field: name → size → created → type → extension → none |
R | Toggle reverse sort order |
A | Open cart view |
D | Open downloads view |
M | Open my shares view |
o | Offline download — enter URL or magnet link |
O | Offline tasks view |
t | Trash view |
Space | File/folder info popup |
p | Preview file content (text preview / fetch listing) |
l | Toggle log overlay |
: | Go to path — type a cloud path and press Enter |
, | Settings panel |
h | Help sheet |
? | Actions menu |
q | Quit (confirms if downloads are active) |
Ctrl+C | Quit (confirms if downloads are active) |
Recent operation results appear as a short-lived status message without opening the log overlay. The same messages remain available in the log.
Actions Menu
Press ? to browse the available actions with their shortcuts. Use j / k
or the arrow keys to select an action, Enter to run it, and Esc or ? to
close. The menu also supports the mouse wheel, single-click selection, and
double-click activation.
Delete confirmation
Pressing d opens a confirmation prompt:
y— move to trash (recoverable)p— opens a second prompt asking you to typeyesand press Enter for permanent deletionn/Esc— cancel
Folder Picker (Move / Copy)
Appears when move_mode = "picker" (default). A two-pane folder navigator.
| Key | Action |
|---|---|
j / k | Navigate folders |
Enter | Open folder |
Backspace | Go to parent |
Space | Confirm destination |
/ | Switch to text input mode |
Esc | Cancel |
Text Input
All text fields — login, rename, new folder, paths, URLs, player command, and local transfer destinations — support cursor-aware editing.
| Key | Action |
|---|---|
← / → | Move by one Unicode character |
Home / End | Move to the start / end |
Backspace / Delete | Delete before / at the cursor |
Ctrl+A / Ctrl+E | Move to the start / end |
Ctrl+W | Delete the previous word |
| Type | Insert at the cursor |
Esc | Cancel |
Long values scroll horizontally to keep the cursor visible. Cloud path fields used for move/copy add these controls:
| Key | Action |
|---|---|
Tab | Autocomplete cloud path |
Enter | Select completion / confirm destination |
Ctrl+B | Switch back to folder picker |
Esc | Close completions first, then cancel |
Cart View
Add multiple files with a, then batch-download, move, copy, or share them all at once.
| Key | Action |
|---|---|
j / k | Navigate |
x / d | Remove selected item from cart |
a | Clear all items |
Enter | Download all — prompts for local destination |
m | Move all items (folder picker) |
c | Copy all items (folder picker) |
t | Trash all items |
s | Share all items (prompts: p = plain link, P = password-protected) |
S | Share all (plain link, no prompt) |
Esc | Close cart view |
Download View
Press D to open the download manager. Active downloads show progress in real time.
| Key | Action |
|---|---|
j / k | Navigate tasks |
Enter | Toggle collapsed / expanded view |
p | Pause / resume selected task |
x | Cancel and remove selected task |
r | Retry a failed task |
Esc | Close (downloads continue in background) |
Trash View
Press t to open the trash. Files deleted with d → y land here.
| Key | Action |
|---|---|
j / k | Navigate |
Enter | Toggle collapsed / expanded |
u | Restore (untrash) selected item |
x | Permanently delete selected item |
Space | Show file info popup |
r | Refresh trash listing |
Esc | Close (or collapse expanded view) |
Offline Tasks View
Press O to view server-side download tasks.
| Key | Action |
|---|---|
j / k | Navigate |
r | Refresh task list |
R | Retry selected failed task |
x | Delete selected task |
Esc | Close |
Video Quality Picker
Appears when you press Enter on a video file or use w for explicit stream selection.
| Key | Action |
|---|---|
j / k | Navigate quality options |
Enter | Play selected quality with configured player |
Esc | Cancel |
Settings
Press , to open settings. Changes stay in a draft until you press s, which
applies them and persists them to config.toml.
| Key | Action |
|---|---|
j / k | Navigate items |
Space / Enter | Edit / toggle selected item |
← / → | Cycle through options for multi-value settings |
s | Save changes to config.toml |
Esc | Close, or ask before discarding unsaved changes |
At the unsaved-changes prompt, press y / Enter to discard or n / Esc
to return to editing.
Settings include: Nerd Font, border style, color scheme (with custom RGB editor), help bar, quota bar style, show preview, lazy preview, preview max size, thumbnail mode, image protocols, sort field, reverse order, move mode, CLI Nerd Font, player command, concurrent download jobs.
My Shares View
Press M to open your share history.
| Key | Action |
|---|---|
j / k | Navigate |
y | Copy share URL to clipboard |
d / x | Delete share (prompts confirmation) |
r | Refresh shares list |
l | Toggle log overlay |
Esc | Close |
Help Sheet
Press h in the file browser to open the built-in help sheet. On short
terminals, use j / k, arrows, page keys, Home, or End to scroll; press
Esc (or another non-scroll key) to close it.
Mouse Support
- Click — Select entries in file panes and modal lists
- Double-click — Run safe primary actions in file panes, cart, trash, and the player picker; destructive actions still require confirmation
- Scroll wheel — Navigate file panes, help, Actions, cart, downloads, offline tasks, trash, shares, player choices, color/protocol settings, preview, and logs