CLI and terminal UI

Use the CLI for repeatable uploads and the TUI to manage configurations and recent results from your terminal.

Terminal interface

picgo
picgo tui

Run these in an interactive terminal. On first use, select Set up a destination. Without an interactive terminal, bare picgo prints help; tui requires an interactive terminal.

Key	Action
Tab or ← / →	Change action group
↑ / ↓, Enter	Select and run an action
/	Search actions
r	Recent upload results
c / m	Copy the selected result as a URL / Markdown
Esc	Cancel the current form
q	Exit from the menu

Upload and select a destination for one call

picgo upload ./image.png
picgo u ./first.png ./second.jpg
picgo upload ./image.png --picbed github --configName "Work"

--picbed and --configName apply to this upload without overwriting saved defaults. Omitting the provider uses the current one; omitting the name uses that provider's default configuration. See provider IDs.

Manage named configurations

picgo set uploader github "Work"
picgo use uploader github "Work"
picgo config list github
picgo config use github "Work"
picgo config edit github "Work"
picgo config rename github "Work" "Team"

use uploader selects the active provider; config use selects a provider's default named configuration. config show prints configuration values that may include credentials. Keep its output out of public screenshots and issues.

To remove an unused configuration, run picgo config remove github "Team". The command asks for confirmation.

Processing and the secondary uploader

picgo set buildin compress
picgo set buildin watermark
picgo set buildin rename
picgo set secondUploader github "Backup"

Choose shared processing to reuse the primary processed image, or separate processing to start again from the original. buildin is the CLI module name; its corresponding JSON field is buildIn.

Plugins, language, and help

picgo install picgo-plugin-<name>
picgo list
picgo set plugin
picgo use plugins
picgo i18n en
picgo upload --help
picgo config --help

Restart running servers and TUI sessions after plugin changes. See plugins and troubleshooting.