SuiteCraft Beta

Help

Answers to the questions people ask most. Can't find yours? See "Reporting a problem" at the end.

Getting started

What does "beta" mean?

SuiteCraft is new. The apps work, but they are still being built: expect missing features, rough edges and the occasional bug, and some files may not open or save exactly like in the programs they resemble.

  • Keep copies of important work, and don't rely on SuiteCraft alone for it yet.
  • We have not yet been able to test the Windows (ARM64), Linux (ARM64) and macOS (Intel) builds on real machines. They are built the same way as the others; reports from those systems are especially welcome.
  • Updates come often. UpdateCraft brings them in, and each one is checked against signatures before it is used.
  • Please tell us what goes wrong (see Reporting a problem): it is the most useful help right now.
Which download do I need?

The one the download page suggests for your computer. Windows PCs almost always need Windows (x64); Windows on Snapdragon laptops needs Windows (ARM64). Macs from late 2020 on need macOS (Apple silicon), older Macs macOS (Intel). On Linux, run uname -m: x86_64 means Linux (x64), aarch64 means Linux (ARM64).

Do I have to install anything?

No. Unzip the download into any folder and start the apps from there. They don't need administrator rights, and they leave nothing behind in the system.

Where should I put the folder?

Anywhere you can write to: your documents, a second disk, a network share or a USB stick. Avoid folders that sync while you work (such as OneDrive's Desktop), because the apps write their settings into the folder.

Can one USB stick work on Windows, macOS and Linux?

Yes, with one folder per system. Download the zip for each system you need (choose the system above the download button), and unzip each into its own folder on the stick, for example SuiteCraft-Windows, SuiteCraft-macOS and SuiteCraft-Linux. Don't unzip them into the same folder: the macOS and Linux programs have the same names and would overwrite each other.

Each folder has its own UpdateCraft, which keeps all apps in that folder up to date when you run it on its system. Format the stick as exFAT so all three systems can read and write it.

Can I move or copy the folder later?

Yes. Close the apps, then move or copy the whole folder. Settings and data go with it. On Windows, run Create shortcuts.cmd again afterwards so the shortcuts point to the new place.

Do the apps work without the internet?

Yes. Only UpdateCraft needs a connection, to check for updates.

How do I remove SuiteCraft?

If you set up a scheduled update check, turn it off in UpdateCraft's settings first. Then delete the folder and any shortcuts you copied elsewhere. That's all.

Windows

Windows says "Windows protected your PC"

SmartScreen warns about programs it hasn't seen often. Check that the file came from suitecraft.app (and, if you like, check its hash), then choose More info and Run anyway.

Tip: before unzipping, right-click the zip, choose Properties, tick Unblock and press OK. Then Windows won't ask again for every app.

What does "Create shortcuts.cmd" do?

It makes one shortcut per app, with the app's icon, named like "WordCraft (Word)", at the top of the suite folder. Drag them to the desktop or pin them to Start if you like. It changes nothing else. Run it again after adding apps or moving the folder.

My antivirus program stopped an app

New programs that aren't widely used are sometimes flagged by mistake. Compare the file's hash with the one on the download page. If they match, the file is exactly what we published, and you can allow it in your antivirus program.

macOS

macOS says the app "cannot be opened" or "is damaged"

Gatekeeper blocks apps downloaded outside the App Store the first time. Open System Settings, go to Privacy & Security, scroll down and press Open Anyway next to the app's name. You only need to do this once per app.

If macOS says the app is damaged, the download was quarantined as a whole. After you have checked the zip's hash, you can clear the flag for the folder in Terminal: xattr -dr com.apple.quarantine ~/Applications/SuiteCraft (use your own folder path).

Linux

An app says "Permission denied"

Some unzip tools drop the "executable" flag. In the suite folder, run chmod +x */*craft */*craft-cli and try again.

How do I start the apps?

Open the launchers at the top of the suite folder, such as "WordCraft (Word)", or run the program inside each app's folder, such as wordcraft/wordcraft. Each app also has a command-line tool next to it, such as wordcraft/wordcraft-cli.

Updates

How do updates work?

UpdateCraft lives in the suite folder. It checks suitecraft.app for a new suite version, downloads only the apps that changed, verifies them, and replaces the old files. It can do this on a schedule, ask you first, or wait until you press Check now. See Setting up automatic updates.

What is the "suite id" in UpdateCraft?

A random number made on your computer when UpdateCraft first runs. It lets us count how many suites are in use without knowing whose they are. You can see it and switch it off in UpdateCraft's settings. Read more on the privacy page.

I unticked UpdateCraft. Can I add it later?

Yes. On the download page, under Single apps, download UpdateCraft alone and unzip it into the suite folder.

Setting up automatic updates

UpdateCraft can keep the suite up to date by itself, also when its window is closed. You choose which apps it may update without asking, and when it should look. It runs as your own user; nothing needs administrator rights.

On every system

  1. Open UpdateCraft. On Windows, use the shortcut "UpdateCraft (keeps the suite up to date)" that Create shortcuts.cmd made; on macOS and Linux, the launcher with that name in the suite folder.
  2. On the Apps tab, set each app you want updated by itself to Automatic. Ask me only shows new versions; Ignore leaves the app alone. Apps added later get the choice under Settings, Default for new apps.
  3. Open the Settings tab and find Scheduled automatic updates. Then follow the steps for your system below.
Screenshot coming
The Apps tab: each app's update mode (Automatic, Ask me or Ignore).

Windows

  1. Tick Every day at and type a time when the PC is usually on, as HH:MM (24-hour clock).
  2. If the PC is often off at that time, also tick Also at sign-in. With both ticked, it runs at most once a day.
  3. If you like, tick Show a small status window while it runs.
  4. Press Register. UpdateCraft says Scheduled.
Screenshot coming
Windows: Settings tab, Scheduled automatic updates, after pressing Register.

UpdateCraft makes a task in Task Scheduler named "UpdateCraft" followed by a short code, for your user only. If Windows refuses the sign-in part without administrator rights, UpdateCraft uses a small script in your Startup folder for it instead. For more choices, such as only running on mains power, press More options: open Task Scheduler and open the task under Task Scheduler Library.

Screenshot coming
Task Scheduler with the UpdateCraft task in Task Scheduler Library.

macOS

  1. Tick Every day at and type a time, as HH:MM (24-hour clock).
  2. Tick Also at start-up if the Mac is often asleep or off at that time: a run that is missed is not made up later.
  3. Press Register. UpdateCraft adds the schedule to your user's crontab and says Scheduled.
Screenshot coming
macOS: Settings tab, Scheduled automatic updates, after pressing Register.

macOS does not let scheduled jobs read the Documents, Desktop and Downloads folders. If your suite folder is in one of them, move it (for example to a folder called Apps in your home folder) and press Register again. Or allow it: open System Settings, Privacy & Security, Full Disk Access, press +, press Cmd+Shift+G, type /usr/sbin/cron, choose Open and switch it on.

Screenshot coming
System Settings, Privacy & Security, Full Disk Access with cron switched on.

Linux

  1. Tick Every day at and type a time, as HH:MM (24-hour clock).
  2. Tick Also at start-up if the computer is often off or asleep at that time: a run that is missed is not made up later.
  3. Press Register. UpdateCraft adds the schedule to your user's crontab and says Scheduled.
Screenshot coming
Linux: Settings tab, Scheduled automatic updates, after pressing Register.

This needs the cron service. Debian, Ubuntu and Mint have it. On Fedora, run sudo dnf install cronie and sudo systemctl enable --now crond; on Arch, sudo pacman -S cronie and sudo systemctl enable --now cronie.

Checking that it works

  • On macOS and Linux, run crontab -l in a terminal: the UpdateCraft lines end in # updatecraft: and a short code.
  • Each run writes what it did to .updatecraft/scheduled-update.log in the suite folder. The History tab in UpdateCraft shows the updates.
  • To stop the automatic updates, press Unregister in the same place.
Screenshot coming
A terminal showing crontab -l with the UpdateCraft lines.

Checking downloads

How do I check that a zip is genuine?

Versions and hashes lists the SHA-256 hash of every download for every system, along with the programs inside the folder. Work out the hash of your file and compare, or paste it there to see which file it belongs to:

  • Windows (PowerShell): Get-FileHash .\suitecraft-….zip -Algorithm SHA256
  • macOS: shasum -a 256 suitecraft-….zip
  • Linux: sha256sum suitecraft-….zip

The two must match exactly. If they don't, delete the file and download it again.

Why does UpdateCraft not trust the server?

Every release is signed with keys that are kept offline, away from the server. UpdateCraft checks the signature, the size and the hash of each file before it uses anything. Someone who broke into the server could hold updates back, but couldn't make UpdateCraft install a changed program.

Problems

An app won't start

Make sure you downloaded the zip for your system, and that the whole zip was unzipped (not opened in place inside the zip viewer). On Windows, check SmartScreen; on macOS, Gatekeeper; on Linux, permissions.

Reporting a problem

These builds are made by Inndata, so please report problems to us, not to the original authors: write to [EMAIL]. Tell us the system, the app, its version (shown on the download page and in UpdateCraft) and what happened.