Obtinum for developers

Developer documentation

How to get an app or game onto Obtinum, keep it updated and get paid.

Getting started

While developer sign-up is being finished, publishers are added by hand. Email hello@obtinum.com with your app or game, a link to its website or repository, and the platforms it runs on. You will get a developer account and a store page to fill in.

Publishing

  1. Verify you own the app through GitHub, GitLab or a DNS TXT record on your domain.
  2. Add an obtinum.toml file describing the listing.
  3. Push your first build with the obtinum command-line tool.
  4. Wait for the automatic checks and a person's review of the first release (usually within two working days).

The obtinum.toml file

name = "Filixir"
kind = "app"                 # or "game"
platforms = ["windows-x64", "windows-arm64"]
category = "files-storage"   # games: genres = ["puzzle", "strategy"]
tags = ["converter", "offline"]
price = { model = "free", pro = 19.99 }   # "free", "paid", "pay-what-you-want"
website = "https://filixir.app"
privacy = "https://filixir.app/privacy"

[requirements.minimum]       # games
os = "Windows 10 64-bit"
memory = "8 GB"

Uploading builds

Each platform and build type gets its own channel, with a beta channel beside it.

obtinum push quartifex/filixir:windows-x64 ./build --version 1.2.0
obtinum push quartifex/filixir:windows-x64-beta ./build --version 1.3.0-beta.1

Builds can be pushed from GitHub Actions with an upload token. Buyers download only the parts that changed.

Checks and review

  • Every build is scanned for malware and checked for a valid code signature.
  • A person reviews your first release and any release that changes permissions, publisher or signature.
  • Other updates go live as soon as the automatic checks pass.

Licence keys

Every paid purchase issues a key in the buyer's account. Your app checks it with one request; refunds and lost chargebacks revoke it automatically.

GET https://obtinum.com/api/licence/verify?key=OBT-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

Getting paid

Payouts go out monthly once your balance reaches $50, 14 days after each sale so refunds can be covered. The cost of the transfer is taken from the payout. See fees and comparison for what Obtinum keeps from each sale.