Twine tutorial part 1: Installation
Let's get started!
Twine comes with two installation methods, you can either install it on your PC or launch it on your favorite browser. I suggest running the browser version, but I will cover the system installation as well in the detailed explanation.
-
To Launch it Just press the “Use in your browser” button and you are in!
Detailed explanation:
-
To install it to your system follow my steps:
-
Press the “Download desktop app” button. In my case the latest version is 2.9.2, but that might be different for you, don’t worry about it and use the latest release (the version at the topmost when you open the page)
-
Select your OS and architecture;
-
Windows: As of now, Windows version only has “x86-64” architecture option but in your case in the future there can be an arm64 so to check that you need to do the following things (for consistency’s sake between windows versions I’m going to show you the command prompt way); First open your start menu or press the Windows key. Then type cmd, you will see a program called “Command Prompt” press enter, and type the following to your Command Prompt
systeminfo | findstr /B "System Type"
If you get the result, “x86-based PC” your computer is 32 bit and you should use the browser version instead. If you get “x64-based PC” your computer is 64 bit and using an Intel or AMD based processor which is not Arm so you are good to go with this version. If you get something like “ARM64-based PC” for now you need to use the browser version. However, if there would be a ARM64 option in the future select that version on the downloads. -
macOS: If you are using macOS or a Hackintosh, you should select the “macOS” version. It should work for both Intel and M series Mac’s, so regardless of architecture, use the “macOS” version. If you happen to have an ancient Mac (i.e. PowerPC series) you should use the browser version. You can check your architecture by, opening the “System” or “Apple” menu on the top leftmost (the Apple logo) or pressing the “Command(⌘)” key and then typing “Terminal” and pressing the “Return” key (“Enter” key). Once the terminal starts, type
sysctl machdep.cpu
in your terminal. -
Linux: If you are on a Linux derivative (i.e. Ubuntu, Arch Linux, Fedora etc.) you should first check your architecture by opening your by pressing Super button (in most cases) (The super key is the equivalent of Windows key in Linux so you can press the Windows button if you have the Windows logo there). If you are on Mac and using Linux (i.e. Asahi Linux or its derivatives for M series Mac’s or any other Linux derivatives on Intel based Mac’s) press the “Command(⌘)” key. And type “Terminal” (in most cases) or the name of the terminal you are using and open it. Then type this command to your terminal
uname -m
if the result is “x86_64” you should select the “Linux x64” option if the result is “i686” or “i386” your computer is 32 bit and you should use the browser version instead. If the result is something like “ARM64” select the “Linux arm64” version. If it’s anything else (i.e. RISC-V etc.) you should use the browser version. As an addition Twine might be in your package manager, but as of now twine does not exist in any repository except for an unofficial Flatpak, to install it do the following steps, Install Flatpak to your system (if not already installed). This varies from distribution to distribution. So find your distribution from this list and click it. In case you don’t know what Linux distribution you are running enter the following command to your terminal;cat /etc/os-release
if this doesn’t return any value try;cat /etc/SuSE-release
if that also doesn’t return any value trycat /etc/gentoo-release
in all these cases you should look for the name field. If none of these return any value try all the examples here. If none of these work you are either using Linux From Scratch or have a broken/severely outdated Linux system, or you don’t run Linux. At any of these three cases I recommend not using the Flatpak option. After you installed Flatpak type the following commands to your terminal;flatpak remote-add --if-not-exists flathub \ https://flathub.org/repo/flathub.flatpakrepo
and then type the following commandflatpak install flathub org.twinery.Twine
. To run it find it in your application/start menu (if exists) if you can’t find the Twine entry enter the following command:flatpak run org.twinery.Twine
. If you don’t want to use Flatpak there is also the Snap option. Once again do the same operating system finding procedure, this time install the snapd package. Optionally run this comment for old snap compatibilityln -s /var/lib/snapd/snap /snap
And then run the following commandsudo snap install twinejs
. -
Other: Unfortunately there is no way to install Twine in other operating systems. You can use the Linux compatibility mode on some of the BSD derivatives but just running on your browser will be easier.
-
-
To install/run Twine, depending on your OS procedure changes:
-
Windows: Open the downloads folder, then open the “Twine(the version you downloaded).exe” Then press the next/install button every time it asks you to. After the installation you can run Twine from your start menu or (depending on your choices) from your desktop.
-
macOS: Double-click the downloaded “Twine(the version you downloaded).dmg” file. It will open a little “drag and drop” window telling you to drag the Twine icon to the “Applications” folder. After that it will automatically install itself in a short while. You find Twine in your “System” or “Apple” menu after the installation is complete.
-
Linux: procedure between the Arm and x86-64 versions are the same. Just extract the downloaded file via either the archive manager of your choice by opening the archive and pressing extract or via terminal with the command
unzip Twine(the version you downloaded).zip
. In case you don’t have the unzip utility, please install it via your package manager, to do that, check this. After finding your distribution, click on it and then (if exists) click the entry that is just “flatpak-(version number)”. If you can’t find your distribution here, I’m afraid you have to compile from source. That’s severely out of the scope of this tutorial, so I will link the required steps here. If you don’t know what Linux distribution you are running, please check back to the 2. steps Linux part. After extracting, open the extracted folder try to run the file twine in your file browser, or in terminal you can type./twine
in the extracted folder (to get to that folder you may want to use the commandsls
(which lists the folder contents) andcd
(which changes the directory)). If running twine fails, please open your terminal and write the following commandchmod +x twine
and try again. If it fails once again you probably don’t have the permissions to use it and need to change the whole folders permissions withchmod -R 777 .
while in the folder. If none of these work, you are quite possibly running the wrong version for your architecture. After these steps, run the “twine” program again. You are ready to go!
-
-