Caution
This project is under development and is not ready for use.
- 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
*When tested on KDE Plasma Wayland 6.2.90 with HDR, the resulting screenshots' 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.
- 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 play back video
- 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. 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 project, with one main goal: ShareX on Linux on 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: 
gitdotnet-sdk-9.0ffmpeg(7)clangzlib-develcurl-develvlc-libs(libvlc, Runtime dependency)
JetBrains Rider is the recommended IDE. It works on Linux, Windows, and macOS. It's free for noncommercial use.
sudo dnf in -y git dotnet-sdk-aot-9.0 /usr/bin/ffmpeg 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 dotnet-sdk-9.0 ffmpeg clang libvlc-dev zlib1g-dev libcurl4-openssl-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.RiderEnd 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 -lCaution
Only do this if you're a developer; 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.
Important
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 that it expects.
On Linux, it's ~/.config/SnapX
On Windows, it's %USERPROFILE%\Documents\SnapX
On macOS, it's ~/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
# 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.
