Steam Achievement Manager For Linux. Rewritten in C++.
Steam Achievement Manager For Linux. Rewritten in C++.
This is the legacy version of SamRewritten. It stood the test of time and should still work with modern Linux environments.
New developments and features are being developed on the new rewritten version: SamRewritten
The new version aims to:
If there is something this version can do the new can't, please let us know!
SamRewritten is an open-source desktop application that allows you to unlock and relock your Steam achievements. It is named after the famous Steam Achievement Manager written by Gibbed, and implements its functionalities on Linux, and more!
SamRewritten is always evolving, we would be thrilled to listen to your feedback, ideas, and contributions!
AppImage downloads are readily available from the releases tab.
Arch users can install SamRewritten from the AUR by installing the samrewritten-git package.
Run SamRewritten by opening the corresponding desktop entry, or by using the samrewritten command.
On Gentoo, SamRewritten is available as games-util/samrewritten through the GURU overlay.
To build this project from source, clone and enter this repository, and run make.
For Arch users, there is also a PKGBUILD within the package folder if you wish to build it using makepkg.
If you're encountering issues building SamRewritten, make sure you have installed the required packages on your machine. You'll most likely need Steam, curl, yajl, GTK 3, and GLib.
Ubuntu 18.04 and above: $ sudo apt install libgtkmm-3.0-dev libcurl4-gnutls-dev libyajl-dev
Arch and variants: $ sudo pacman -S gtkmm3 glibc gnutls yajl
openSUSE Tumbleweed, Leap 15.2+: $ sudo zypper install gtkmm3 gcc-c++ gnutls libcurl-devel libyajl-devel-static
Fedora 32+: $ sudo dnf install gtkmm30 gtkmm30-devel yajl-devel curl-devel g++
To run your SamRewritten build, use $ ./bin/launch.sh
To build your own AppImage, build SamRewritten normally, then execute build_appimage.sh from the package folder. A new AppImage will be generated with libraries from your system.
SamRewritten's features match and exceed the original SAM:
This last one warrants some explanation. SamRewritten allows you to specify across what time period, with what spacing, and in what order to lock/unlock achievements. For example, you can unlock 10 achievements of your choice in a random order across 4 hours with random spacing between them. This is a powerful tool to allow you to make achievement management look more natural, rather than unlocking them all at once. This option can be accessed in the GUI by starting a game, selecting the achievement modifications, click the menu icon, then selcting Start Timed Modifications. The same functionality can be used with the CLI as well via the --timed parameter - an example is given in the next section.
As linux geeks we love to use command line options! SamRewritten's commandline can do all the operations its GUI can! Given no arguments, SamRewritten will launch graphically.
…Change an achievement or stat value:
# Find what you want from the --ls command for app id 54 (you can retrieve app ids from the store page URL).
samrewritten 54 --ls
# Say we found achievements with IDs ach_500_kills and ach_found_something and stats stat_num_kills, stat_num_deaths
# Modify them like this
samrewritten 54 --unlock ach_500_kills,ach_found_something
samrewritten 54 --statnames stat_num_kills,stat_num_deaths --statvalues 10,1Use the timed unlock on the commandline
# Using the same achievements from the previous example
samrewritten 54 --timed --unlock ach_500_kills,ach_found_something --amount 4 --units hours --spacing random --order randomSamRewritten uses JSON to communicate between the interface and the "backend logic" via sockets. If you plan to make an app using some of SamRewritten's features, feel free to ask for help, for support, for features, or to contribute.
You can find an overview of SamRewritten's internal logic and more in the doc folder. If you need more help getting started, feel free to ask questions and open issues. The more feedback we collect, the better we can make the documentation!
This software is licensed under the GNU GPL v3 and comes with no warranty. Use it at your own risk. We believe you should not get any Steam ban using it, but we do not take any responsibility over your user experience.
SamRewritten includes third party libraries such as the Steam Steamworks SDK, which are subject to licensing by Valve Software.
No open issues yet, or sync has not completed.