Sapphic Angels

OneShot on Linux: The Definitive Guide

Wed, 03 Apr 2024 00:00:00 GMT

Update

An update from May 28, 2025. (2025-05-28)

Future Cat LLC has released OneShot: World Machine Edition on Steam. It’s worth checking out as it has excellent Linux support!

Original article

Note: this guide assumes you have the Steam version of OneShot.
For the itch.io version of OneShot, please see the “I cannot get the itch.io version to run!” section.

OneShot is one of our favourite games out there. It helped get us through some of our darkest times and it’s our comfort game. We could spend hours talking about it.

Unfortunately, getting it to work on Linux can be quite the challenge. Though the game has a native Linux version, you have to delete certain files for it to launch - but even that is not a guarantee that it will work on all Linux distributions.

It’s simply not feasible for an average user to have to scour the wide Internet for possible solutions just to be able to play OneShot.

That’s why we have decided to write an article guide to make sure one can enjoy the game on Linux with close to no hurdles.

Caveats

Unfortunately, due to the nature of the game, your immersion may be slightly ruined.

For example, the game automatically changing your desktop wallpaper during a certain puzzle won’t work on Linux. See the Desktop wallpaper not changing section for more information.

OneShot is best played and experienced on a Windows environment.

If you don’t mind this trade-off though or simply don’t care, keep on reading.

Prerequisites

You will need to install Protontricks.

Installing Protontricks

There are several ways to install Protontricks.

If you already have Protontricks installed, you can skip to the Running the game section.

Method 1: Installing Protontricks as a Flatpak package

If you have Flatpak installed, you can run the following command to install Protontricks:

flatpak install flathub com.github.Matoking.protontricks

To install Flatpak for your Linux distribution, you can follow Flathub’s guide.

Method 2: Installing Protontricks as a system package

Alternatively, you can install Protontricks as a system package.

Here are the following commands to install Protontricks for the most popular Linux distributions:

Arch Linux: Protontricks is available via the AUR.
- paru: paru -S protontricks
- yay: yay -S protontricks
Debian 12+: sudo apt install protontricks
Fedora 32+: sudo dnf install protontricks
NixOS 21+: nix-env -iA protontricks
Ubuntu 22+: sudo apt install protontricks
Void Linux: xbps-install protontricks

If your Linux distribution is not listed here, check out the “Installation” section on the Protontricks repository for more information.

Running the game

We’ll be using Valve’s Proton compatibility layer to play OneShot.

For the majority of the game, you won’t have to use Protontricks. It’s only near the end that you’ll be forced to run a certain executable file in order to progress further. (Jump to ‘Later stages of the game’ section)

Head over to your library, right click OneShot, select “Properties…” and head over to the Compatibility tab.

Enable “Force the use of a specific Steam Play compatibility tool”, and select Proton 7.0-6. This will download that specific Proton version, which might take a while.

Once that’s done, you can launch OneShot from your Steam library and the majority of the game will run just fine!

Interacting with documents

In some parts of the game, you may have to interact with files. Usually, these files are located in the My Documents folder on Windows.

With Proton, your documents for OneShot are located in the ~/.steam/steam/steamapps/compatdata/420530/pfx/drive_c/users/steamuser/Documents folder.

I’m sure you don’t feel like memorizing that, so let’s create a symlink (think of it as a shortcut, basically) for easy access!

We’ll be creating a symlink in your home directory. Run the following command to create a ProtonDocuments symlink in your Documents folder:

ln -s ~/.steam/steam/steamapps/compatdata/420530/pfx/drive_c/users/steamuser/Documents ~/Documents/ProtonDocuments

Now whenever the game creates a document file, you can always access it under your Documents folder! (~/Documents/ProtonDocuments)

You may see additional folders like Downloads, Templates, Videos and so on in the ProtonDocuments folder, but don’t worry about them!

Later stages of the game

Though most of the game will work and play fine, eventually, you’ll have to run a file named _______.exe (we’ll be calling this the “clover program” for the rest of the guide) in order to progress further in the game. This is where Protontricks comes into play.

Using protontricks-launch, run the following command to launch the clover program:

protontricks-launch --appid 420530 ~/.steam/steam/steamapps/compatdata/420530/pfx/drive_c/users/steamuser/Documents/My\ Games/Oneshot/_______.exe

Afterwards, launch OneShot via its steamshim binary:

protontricks-launch --appid 420530 ~/.steam/steam/steamapps/common/OneShot/steamshim.exe

Note: The Steam overlay will be unavailable under Protontricks, however achievements will work pretty much just fine.

Aliasing the commands

If you want to have these commands at an easy reach, you can add them as an alias to your shell file. In our case, we’ll be using Bash, but you can modify the example below to work with zsh, fish, and other shells.

Open the ~/.bashrc file with the editor of your choice, and add the following code to the end of the file:

alias launch-oneshot="
protontricks-launch --appid 420530 ~/.steam/steam/steamapps/common/OneShot/steamshim.exe
"

alias launch-oneshot-clover="
protontricks-launch --appid 420530 ~/.steam/steam/steamapps/compatdata/420530/pfx/drive_c/users/steamuser/Documents/My\ Games/Oneshot/_______.exe
"

Now you can launch OneShot and the clover program by just typing launch-oneshot and launch-oneshot-clover respectively in your terminal!

Spoilers for OneShot

Questions and answers

I’m getting the “Failed to initialize Steamworks” error!

You need to have Steam running on your host machine when you execute the steamshim file.

I cannot get the itch.io version to run!

Due to an AppImageKit bug, the .appimage file provided on the itch.io version of OneShot is broken.

For the time being, you can use the following snippet provided by Leo.

./OneShot.AppImage --appimage-extract

rm squashfs-root/usr/lib/libgmodule-2.0.so.0
rm squashfs-root/usr/lib/libgtk-x11-2.0.so.0
rm squashfs-root/usr/lib/libgdk-x11-2.0.so.0

wget https://archive.archlinux.org/packages/l/libffi/libffi-3.3-4-x86_64.pkg.tar.zst
mkdir libffi
tar -xC libffi/ -f libffi-3.3-4-x86_64.pkg.tar.zst
cp libffi/usr/lib/libffi.so.7.1.0 squashfs-root/usr/lib/libffi.so.7

./squashfs-root/usr/bin/oneshot

Where can I view my save files for OneShot?

Your save and config files for OneShot are located in the ~/.steam/steam/steamapps/compatdata/420530/pfx/drive_c/users/steamuser/AppData/Roaming/Oneshot folder.

If you end up interacting with your save files often, you can create run the following command:

ln -s ~/.steam/steam/steamapps/compatdata/420530/pfx/drive_c/users/steamuser/AppData/Roaming/Oneshot ~/Documents/OneShotSaves

This will create a OneShotSaves symlink in your Documents folder for easy access:

My desktop wallpaper is not updating!

In the native Linux version of OneShot and on Windows, the game is able to automatically change your wallpaper during a certain puzzle in the Glen region.

Unfortunately, this is not possible with Proton as the game is running on Wine, which, to our knowledge anyway, is not able to change the host machine’s desktop wallpaper.

We have not found a solution for this issue. For the time being, you can change the wallpaper manually by going to the ~/.steam/steam/steamapps/common/OneShot/Wallpaper folder and selecting desktop.png as your wallpaper. You can change the wallpaper back after you’re done with the puzzle.

Alternatively, you can just open the image for the duration of the puzzle.

Can I play Solstice with this?

Yes. Just delete the save_progress.oneshot file in your ProtonDocuments/My Games/Oneshot folder and execute the steamshim.exe file with Protontricks (or run the launch-oneshot alias command above).

I know how to fix X or I want to include Y in this guide!

Cool! Just leave a comment below or contact me and I’ll update the article.

Concluding thoughts

As much as we love OneShot, we honestly wish it was updated to work well to run natively on Linux just fine with no additional tweaking, or at the very least, updating the game to work on the latest Proton versions.

No hate towards the developers of the game though! We know it must be pretty hard to support the Linux version of OneShot and ensure it runs well across all distributions and configurations.

Thank you for reading ‘till the end!

Using Cloudflare R2 as your primary storage on ownCloud

Sun, 02 Apr 2023 00:00:00 GMT

Introduction

We have a compute instance that is running ownCloud, which we use to backup our files and whatnot. While we were configuring the instance and uploading our files, we quickly realized that our instance’s storage is very limited and did not have enough space to actually house all of our potential future backups.

But then we had an idea: what if we could hook up Cloudflare’s R2 service to ownCloud?

Stick with us as we show you how to do exactly that in this article.

Preamble

Notice

This guide assumes you’re running an instance of ownCloud on a Docker container using docker-compose.

If you don’t have an instance of ownCloud running on Docker, follow these steps:

You’ll need to install Docker first. The official Docker Docs page provides a guide on how to install Docker on just about every system.
Then, head over to ownCloud’s documentation page and install ownCloud on a Docker container.

Creating a bucket

Go to your Cloudflare dashboard and navigate to the R2 page. Then click on the Create bucket button.

Warning

When creating a bucket, make sure you give this bucket a unique name because you won’t be able to change it afterwards!

For the purposes of this guide, we’ll stick with the bucket name owncloud-instance.

Once you’re done with that, head back to the R2 page, click on the Manage R2 API Tokens link and click on the Create API token button.

Bucket creation options

Let’s go through each of the options on the page:

Token name: This is not that important, but if you want to be able to easily identify the R2 token on this page in the future, you can set a unique name here.
Permissions: Make sure you set this to Edit! Otherwise you may run into permission issues when uploading files.
TTL: If you just want to create this token and forget about it, set this to Infinity. Otherwise, this option is up to you.

When you’re done, click on the Create API Token button.

You’ll be able to see your Access Key ID and Secret Access Key values here. Keep them somewhere safe, as you will not be able to see them again!

Installing the S3 extension for ownCloud

Once you’re done creating an R2 bucket, head over to your ownCloud admin dashboard.

Click on the menu bar located in the upper left corner, and select the Market tab.

Scroll down until you find the S3 Primary Object Storage extension, and install it.

Notice

Note, you’ll want this extension and not the extension called “External Storage: S3”!

Setting up R2 for your ownCloud instance

Warning

Before proceeding any further, make sure you back up all your data! Proceeding with the steps below will wipe any data you had on your ownCloud instance.

You’re done with all that? Great. It’s time to configure R2 to work on your ownCloud instance.

Run the following command to access the filesystem of your ownCloud Docker instance:

> docker exec -t -i owncloud_server /bin/bash

Head over to the config folder. The config folder should have the following files:

> ls
config.php  objectstore.config.php  overwrite.config.php

We’re looking to edit the config.php file. Add the following to the configuration file:

'objectstore' => [
  'class' => '\\OC\\Files\\ObjectStore\\S3',
  'arguments' => [
    'bucket' => 'BUCKET',
    'autocreate' => true,
    'key'    => 'ACCESS_KEY_ID',
    'secret' => 'SECRET_ACCESS_KEY',
    'hostname' => 'ACCOUNT_ID.r2.cloudflarestorage.com',
    'port' => 443,
    'use_ssl' => true,
    'region' => 'auto',
  ],
]

S3 configuration options

You’ll want to replace the following options:

bucket: This is your unique R2 bucket name that you created earlier. (I used owncloud-instance for this guide)
key: This is the Access Key ID that you obtained when creating the R2 bucket.
secret: This is the Secret Access Key that you obtained when creating the R2 bucket.
hostname: You can find the bucket hostname on the bucket page itself. Make sure to only include the URL name! (the /owncloud-instance bit from the URL can be removed)

Then, run docker restart owncloud_server to apply the changes.

And that’s it! Log back in to your ownCloud admin dashboard, and your instance should utilize your Cloudflare R2 bucket as its primary storage.

Conclusion

Overall, it’s pretty painless for your ownCloud instance to utilize Cloudflare’s R2 service.

We will warn you though, Cloudflare’s base plan for R2 only includes 10 GB of storage per month.

But it all depends if you’re fine with that. :)

Hey! If you’re still here…

This is the first time we’re writing a blog post of this sort. Let us know if we did well, or if there’s anything we can improve with future blog posts. Thank you! ❤️

Sapphic Angels

OneShot on Linux: The Definitive Guide

Update#

Original article#

Prerequisites#

Installing Protontricks#

Method 1: Installing Protontricks as a Flatpak package#

Method 2: Installing Protontricks as a system package#

Running the game#

Interacting with documents#

Later stages of the game#

Aliasing the commands#

Questions and answers#

I’m getting the “Failed to initialize Steamworks” error!#

I cannot get the itch.io version to run!#

Where can I view my save files for OneShot?#

My desktop wallpaper is not updating!#

Can I play Solstice with this?#

I know how to fix X or I want to include Y in this guide!#

Concluding thoughts#