SnapX is a hard fork of the Windows application ShareX.
- SnapX is a cross-platform application.
- Elegance in user interfaces by separating essential settings from advanced or intermediate functionality
- Supporting high DPI screens
- Screenshots on an HDR monitor aren't blown out*
- Cross-platform OCR powered by PaddleOCR that rivals PowerToys OCR, ShareX OCR, & Windows 10 built in OCR in accuracy
[1]: When tested on KDE Plasma Wayland 6.2.90 with HDR the resulting screenshot's colors were not blown out. Your mileage may vary.
- It uses .NET 9, ImageSharp (cross-platform image library)
- Dependency on Newtonsoft.JSON dropped, traded out for more strict yet performant System.Text.Json
- And it will use SQLite to store settings & history by default yet keeping JSON as an option.
- The UI is now defined in a more modern, declarative style using MVVM and XAML, providing a clear improvement over the older WinForms approach. For SnapX.GTK4, it uses BindingSharp
- UI is GPU accelerated, leading to a more responsive UI & yet less CPU usage while navigating the UI. (Fixes low performance on 4K screens with a weak CPU)
- Respects XDG directory specification and uses XDG portals on Linux
- Supports PNG (including animated variant), WEBP (including animated variant), JPEG, GIFs (should be smaller than your typical ShareX GIF), TIFF, and BMP image formats.
- Supports 95% of ShareX uploaders (we're a fork!!)
- Uses the power of VLC to playback video on Avalonia & uses Gstreamer on GTK4
- Supports Google Photos Image Uploader after the new API change.
- The ability to fully configure SnapX via the Command Line via command flags & environment variables. Additionally, you can configure SnapX using the Windows Registry.
- Additionally, all uploaders are now forced to use HTTPS <2.0 & optionally use TLS 1.3 out of the box.
- Keeps compatibility with the custom uploader configuration format (.sxcu)
- As a user, you do NOT need to have .NET installed. Whether you're on Linux, Windows, or macOS.
What does this all mean? It means you'll be able to have a more performant, reliable, and modern application.
You will not receive any support from the ShareX project for this software. If you have any issues with this project, please open an issue in this repository.
However, it's important to note that this project is maintained by volunteers, and we may not be able to provide support for all issues. We will do our best to help you, but we cannot guarantee that we will be able to resolve your issue.
For further information, please check the source code.
This project is built on Ubuntu 24.04 and is tested on the following distributions:
- Fedora 41+
- Ubuntu 24.04+
If you're using a different distribution, there will be a Flatpak package available when possible. If you're using a distribution that doesn't support Flatpak, you can build the project from source.
When I initially started this port, I only came with one main goal: ShareX on Modern Linux on native Wayland. I realized my work could be used on other platforms such as macOS or Windows...
That's why SnapX.Avalonia was created.
Powered by FluentAvalonia, it should look something like this.
Screenshot from FluentSearch: 
For screenshots, it uses your operating system's respective APIs. On Linux Wayland, it uses portals. This is a less performant implementation as it has to delete the requested screenshot file after reading it into memory.
Instructions for other projects within the SnapX solution are not provided yet.
SnapX.GTK4 does not use header files and only requires the binary GTK4 package at runtime.
gitgtk4&gstreamer(and respective plugins) (Installed by default on Ubuntu & Fedora)dotnet-sdk-9.0ffmpeg(7)clangzlib-develcurl-develvlc-libs(libvlc)
JetBrains Rider is the recommended IDE. It works on Linux, Windows, and macOS. It's free for noncommercial use.
sudo dnf in -y git gtk4 dotnet-sdk-9.0 /usr/bin/ffmpeg clang zlib-devel @c-development @development-libs vlc-develsudo apt update && sudo apt install -y software-properties-common
sudo add-apt-repository ppa:dotnet/backports -y # Ubuntu 24.04 doesn't have .NET 9 packaged. Do not add this PPA on Ubuntu 24.10+
sudo add-apt-repository ppa:ubuntuhandbook1/ffmpeg7 -y # Ubuntu 24.04 doesn't have FFMPEG 7 packaged.
sudo apt install -y git libgtk-4-1 dotnet-sdk-9.0 ffmpeg clang libvlc-devEnd of life Windows versions are not supported. For example, Windows 11 22H2 is at its EOL and, thus, unsupported.
# Installing Visual Studio Community
# You cannot build with NativeAOT without it on Windows. It has the linker program. However, you can compile on Rider or whatever your favorite IDE is after you've installed Visual Studio.
# See https://learn.microsoft.com/en-us/dotnet/core/deploying/native-aot
winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.VisualStudio.Workload.NativeDesktop --includeRecommended"
winget install -e --id Git.Git
# Install Rider (optional)
winget install -e --id JetBrains.Rider End of life macOS versions are not supported. For example, macOS Monterey is at its EOL and thus, unsupported.
Using this script from .NET team makes sure you don't run into homebrew .NET weirdness with Rider not detecting it.
curl -O https://dot.net/v1/dotnet-install.sh # Official installation script from .NET team
chmod +x dotnet-install.sh
./dotnet-install.sh -Channel current
git --version # If prompted to install Git, do it.
exec $SHELL -lOnly do this if you're a developer; you should have a backup of all your ShareX/SnapX data. I do, in fact, mean it when I say the project isn't ready for use.
Additionally, it seems SnapX hasn't been able to create the configuration file(s) it expects. I've been testing with my ShareX configuration. You should place it in the configuration directory it expects.
On Linux, its ~/.config/SnapX
On Windows, its %USERPROFILE%\Documents\SnapX
On macOS, its ~/Library/Application Support/SnapX
git clone https://github.com/BrycensRanch/SnapX
cd SnapX
./build.sh # Calls NUKE (https://nuke.build) (Linux/macOS)
.\build.ps1 # If on Windows
Output/snapx-ui/snapx-ui # Run SnapX.Avalonia
Output/snapx-gtk/snapx-gtk # Run SnapX.GTK4
# nothing is stopping you from using regular .NET building tools
# dotnet publish -c Release
# SnapX.Avalonia/bin/Release/net9.0/linux-x64/publish/snapx-uiContributions are welcome. The documentation for contributing is a work in progress, but here is a rough draft.
