adbtuifm

March 16, 2022 ยท View on GitHub

Go Report Card

adbtuifm

demo

adbtuifm is a TUI-based file manager for the Android Debug Bridge, to make transfers between the device and client easier.

It has been tested only on Linux. Windows/Mac is currently not supported.

This is a work in progress.

Features

  • Multiselection support, with a selections editor

  • Transferring files/folders between the device and the local machine

  • Open files of any file type from the device or local machine

  • Copy, move, and delete operations on the device and the local machine
    separately

  • View file operations separately on a different screen, with ability to monitor
    progress and cancel operation

  • Execute commands on the device or local machine, with toggleable
    foreground/background execution modes

  • Filter entries in each directory

  • Rename files/folders or create directories

  • Switch between adbtuifm and shell easily

  • Change to any directory via an inputbox, with autocompletion support

Installation

go get -u github.com/darkhz/adbtuifm

Usage

adbtuifm [<flags>]

Flags:
  --remote=<path>     Specify the remote(ADB) path to start in
  --local=<path>      Specify the local path to start in

Keybindings

Main Page

OperationKey
Switch between panesTab
Navigate between entriesUp/Down
Change directory to highlighted entryEnter/Right
Change one directory backBackspace/Left
Switch to operations pageo
Switch between ADB/Local (in each pane)s/<
Change to any directoryg/>
Toggle hidden filesh/.
Execute command!
Refreshr
Movem
Put/Paste (duplicate existing entry)p
Put/Paste (don't duplicate existing entry)P
Deleted
Open filesCtrl+o
Filter entries/
Toggle filtering modes (normal/regex)Ctrl+f
Sort entries;
Clear filtered entriesCtrl+r
Select one itemSpace
Inverse selectiona
Select all itemsA
Edit selection listS
Make directoryM
Toggle top-down/right-left layout[
Swap panes]
Rename files/foldersR
Reset selectionsEsc
Suspend to shellCtrl+z
Launch local/ADB shellCtrl+d/Alt+d
Help?
Quitq

Operations Page

OperationKey
Navigate between entriesUp/Down
Cancel selected operationx
Cancel all operationsX
Switch to main pageo/Esc

Change Directory Selector

OperationKey
Navigate between entriesUp/Down
AutocompleteTab
Change directory to highlighted entryEnter
Move back a directoryCtrl+w
Switch to main pageEsc

Selections Editor

OperationKey
Select one itemAlt+Space
Inverse selectionAlt+a
Select all itemsAlt+A
Save edited listCtrl+s
Cancel editing listEsc

Execution mode

OperationKey
Switch between Local/Adb executionCtrl+a
Switch between Foreground/Background executionCtrl+q

Notes

  • As of v0.5.5, keybindings have been revised and the UI has been revamped.

  • More information about an entry will be shown only in the top-down layout.

  • Only Copy operations are cancellable. Move and Delete operations will persist.

  • The current method to open files is via xdg-open. In certain cases, after opening
    and modifying a file, the application may take time to exit, and as a result no operations
    can be performed on the currently edited file until the application exits. For example, after
    opening a zip file via file-roller, modifying it and closing the file-roller GUI, file-roller takes some
    time to fully exit, and since the UI is waiting for file-roller to exit, the user cannot perform operations
    on the currently modified file until file-roller exits.

Bugs

  • In directories with a huge amount of entries, autocompletion will lag. This happens only on the device side (i.e ADB mode), where there is significant latency in transferring and processing the directory listing to the client.