ShareX CLI

• Features
• Install
• Configure
• Usage
• Support
• Contributing

Command Line Interface to Upload Files to a ShareX Server using a ShareX Custom Uploader .sxcu configuration.

Upload any file, multiple files, directories, use globs, create archives and much more...

To get started Install the app, Configure your server and view the Usage.

If you run into any issues or have any questions, support is available.

Features

• Use a ShareX Custom Uploader *.sxcu config.
• Upload a file or multiple files.
• Specify a custom file name.
• Upload files in a directory with optional glob.
• Upload a directory as an archive.
• Automatically open the URL in browser.
• Automatically copy the URL to the clipboard.
• Display confirmation before uploading multiple files.
• Override all options with flags or env vars.

Install

From PyPI: https://pypi.org/p/sharex-cli

pip install sharex-cli
uv tool install sharex-cli

From Homebrew: https://github.com/cssnr/homebrew-tap

brew install cssnr/tap/sharex-cli

From GitHub: https://github.com/cssnr/sharex-cli/releases/latest

curl https://i.jpillora.com/cssnr/sharex-cli! | bash

See jpillora/installer for more details.
Alternatively, you can manually download a release for your system.

• Windows Installer amd64
• Windows x86_64 amd64
• macOS Apple Intel amd64
• macOS Apple Silicon arm64
• Linux x86_64 amd64
• Linux ARM arm64

Configure

To configure you need your server's ShareX Custom Uploader *.sxcu configuration JSON.

The --config command allows you to enter the file path, or open a text editor.

sharex --config

Or pass the config path directly to --config.

sharex --config path/to/config.sxcu

Usage

To use run the sharex command with the path to the file to upload.

sharex file.txt
sharex file1.txt file2.txt
sharex file.txt -n name.txt

Directories can be uploaded as files using a glob (default *) or as an archive.

sharex dir1  # non-recursive
sharex dir1 -g '**'  # recursive
sharex dir1 -a  # create an archive

Tip: you will be shown a confirmation before files are uploaded.

Support

If you run into any issues or need help getting started, please do one of the following:

• Report an Issue: https://github.com/cssnr/sharex-cli/issues
• Q&A Discussion: https://github.com/cssnr/sharex-cli/discussions/categories/q-a
• Request a Feature: https://github.com/cssnr/sharex-cli/issues/new?template=1-feature.yaml
• Request Server Support: https://github.com/cssnr/sharex-cli/issues/new?template=2-server.yaml
• Chat with us on Discord: https://discord.gg/wXy6m2X8wY

Contributing

If you would like to submit a PR, please review the CONTRIBUTING.md.

Please consider making a donation to support the development of this project and additional open source projects.

For a full list of current projects visit: https://cssnr.github.io/