Skip to content

Testing

Jump to bottom
Brycen G edited this page Oct 11, 2025 · 4 revisions

Preface

SnapX currently does not have a working settings page.

Thus, you need to import your desired ShareX configuration to make SnapX use it.

Caution

You should have a backup of all your ShareX/SnapX data.
I do mean it when I say the project isn't ready for use.

Setting up ShareX on Linux/macOS

Do not use any version past ShareX 18.0.1, see the reason here.

Prerequisites:

  • Wine >= 9
  • Winetricks
  • curl
  • unzip
cd ~/Downloads
wcurl https://github.com/ShareX/ShareX/releases/download/v18.0.1/ShareX-18.0.1-portable.zip
unzip ShareX-18.0.1-portable.zip -d ShareX-18.0.1-portable
winetricks dlls corefonts
cd ShareX-18.0.1-portable
wine ShareX.exe

Exporting configuration

Important

You must export your configuration. ShareX encrypts passwords and the like in the actual configuration files.

image

Importing configuration to SnapX

  • Extract the sxb file (it is a renamed zip file)

Important

You should place the contents in the configuration directory that it expects.

On unsandboxed Linux/FreeBSD, it's ~/.config/SnapX

On Flatpak, it's ~/.var/app/io.github.SnapXL.SnapX/config/SnapX

On Snap, it's ~/snap/ui-snapx/current/.config/SnapX

On Windows, it's %USERPROFILE%\Documents\SnapX

On macOS, it's ~/Library/Application Support/SnapX

Using Custom Uploaders in SnapX

SnapX uses the same format for custom uploaders and is compatible. We will not impose breaking changes to the format, and will follow ShareX's lead on any improvements made to it.

To import an uploader, use the command snapx-ui -customuploader "<path to sxcu file>"

For Flatpak users, replace snapx-ui with flatpak run io.github.SnapXL.SnapX

For Snap users, replace snapx-ui with ui-snapx

Further testing

As a general rule of thumb, SnapX is compatible with ShareX's CLI arguments. See https://getsharex.com/docs/command-line-arguments

Clone this wiki locally