Free & open source · Windows

File association,
wired into the Registry.

OrBase registers its own .orb and .orun file types in the Windows Registry. Write your code in a .orb file, declare its language with --lang:, and double-click the matching .orun to run it — in any of twelve languages. One tiny installer, zero background processes.

12 languages Registry-native No telemetry
12
Languages supported
2
File types added (.orb + .orun)
0
Background services
100%
Open source on GitHub

Built to do one thing well

OrBase doesn't try to be an IDE, a launcher hub, or a shell replacement. It registers clean, predictable file associations the way Windows intends — through the Registry — and then gets out of your way.

True Registry integration

OrBase's .orb and .orun types are written as native HKEY_CLASSES_ROOT ProgID entries — the same mechanism Windows itself uses for every file type on your system.

Double-click to run

Your code lives in a .orb file; the .orun with the same name runs it — cool.orb is run by cool.orun. Double-click it in Explorer and OrBase executes the code with the language you declared.

12 languages, one directive

Declare --lang: python, --lang: rust or any of twelve languages at the top of your .orb file. Missing the compiler or interpreter? OrBase asks you to download it.

Transparent & auditable

Every key OrBase touches is visible in regedit and documented in the repository. You can inspect exactly what was written — and remove it just as easily.

Featherweight footprint

One small OrbaseInstaller.pyw, no services, no tray icon, no scheduled tasks. And when you want it gone, a matching OrbaseUninstaller.pyw removes everything just as cleanly.

Open source on GitHub

The full project lives at turkballbredissus/OrBase-File-Associater. Read the code, file issues, or send a pull request.

Twelve languages, one associator

Every language runs through the same .orb / .orun pipeline — just declare which one you're writing with a --lang: directive at the top of the file.

»_
Batch
--lang: batch
Py
Python
--lang: python
PS
PowerShell
--lang: powershell
JS
JavaScript
--lang: javascript
Rb
Ruby
--lang: ruby
Pl
Perl
--lang: perl
php
PHP
--lang: php
Jv
Java
--lang: java
Lu
Lua
--lang: lua
Go
Go
--lang: go
Rs< div >< div class="name">Rust< div class="ext" >--lang: rust
R
R
--lang: r

OrBase does not auto-detect the language — declare it at the top of your .orb file, e.g. --lang: python. If the language needs a compiler or interpreter you don't have, OrBase asks you to download one.

How OrBase works

No magic — just the documented Windows file-association model, applied to OrBase's own .orb and .orun file types.

  1. Register the file types

    The installer writes two new types into the Registry: .orb for your source code and .orun for running it. Both live as ProgID entries under HKEY_CLASSES_ROOT.

  2. Write your code in a .orb file

    The .orb file opens in VS Code. Declare the language on the first line — e.g. --lang: python. OrBase never guesses the language; your declaration decides.

  3. Run it with .orun

    Double-click a .orun and it runs the .orb that shares its name — cool.orun runs cool.orb. OrBase saves a copy of the code to your temp folder, executes it with the declared language, then deletes the temp copy right after.

  4. Missing a toolchain?

    If a language needs a compiler or interpreter that isn't installed, OrBase asks you to download it. And when you're done with OrBase, OrbaseUninstaller.pyw removes the associations cleanly.

Registry Editor — OrBase file types (.orb / .orun)
; Code files → open in VS Code [HKEY_CLASSES_ROOT\.orb] @="OrBase.Code" ; Runner files → execute the code [HKEY_CLASSES_ROOT\.orun] @="OrBase.Run" ; What "open" actually runs [HKEY_CLASSES_ROOT\OrBase.Run \shell\open\command] @="OrBase.exe \"%1\""

Don't trust it — verify it

OrBase asks for administrator rights once, so you deserve to know exactly what it does with them. Every claim below can be checked by anyone, in minutes, with tools already on your PC.

Two registry keys, nothing else

The installer registers .orb and .orun and stops there. No drivers, no startup entries, no scheduled tasks, no browser extensions.

No telemetry, no phoning home

OrBase never sends anything anywhere. Your code runs locally, and the temp copy made for each run is deleted right after it finishes.

Fully reversible

OrbaseUninstaller.pyw removes every key the installer created. You can also reassign the file types anytime in Windows Settings → Apps → Default apps.

Built in the open

Every part of OrBase is public on GitHub — the same code anyone can read, build and audit.

Verify it yourself

Don't take this page's word for it — these three checks take about five minutes.

STEP 01

Read the source

The whole project lives at turkballbredissus/OrBase-File-Associater. If the code doesn't match what this page claims, open an issue.

STEP 02

Inspect the Registry

After installing, open regedit and look at HKEY_CLASSES_ROOT\.orb and HKEY_CLASSES_ROOT\.orun — those are the keys OrBase creates.

STEP 03

Scan the installer

Upload OrbaseInstaller.pyw to any scanner you like. Some antiviruses flag unsigned registry tools as a "potentially unwanted application" — see the FAQ for why that happens.

Installed in under a minute

Download one executable, run it, and your file types are wired up. That's the entire process.

1

Download

Grab OrbaseInstaller.pyw from the GitHub repository using the button below.

2

Run the installer

Launch it and approve the elevation prompt — Registry writes under HKCR require administrator rights.

3

Write .orb, run .orun

Create a .orb file, declare your language with --lang:, and double-click its .orun to execute.

Download OrbaseInstaller.pyw Download OrbaseUninstaller.pyw
github.com/turkballbredissus/OrBase-File-Associater
System requirements
Operating systemWindows 10 or Windows 11 (64-bit)
PrivilegesAdministrator (one-time, for Registry writes)
Disk spaceA few megabytes for the installer itself
EditorVisual Studio Code — required for .orb files (changeable later in Windows Settings → Apps → Default apps)
RuntimesOnly the languages you actually use — OrBase asks you to download a compiler or interpreter when one is missing

Frequently asked questions

Quick answers about how OrBase behaves on your system.

Is editing the Registry safe?
Yes — file associations are exactly what HKEY_CLASSES_ROOT exists for. OrBase only creates the extension and ProgID keys for its own .orb and .orun file types; it does not touch unrelated system settings. Everything it writes is visible in regedit and documented in the GitHub repository.
Is it safe? VirusTotal / my antivirus flagged the installer as malware!
No, OrBase is not malware — the main owner has it installed on their own main computer. Because the installer writes file associations into the Windows Registry, antivirus heuristics commonly flag it as "malware" or a "potentially unwanted application" (PUA). This is a well-known false-positive pattern for unsigned tools that touch the Registry. The full source code is available on GitHub, so you can review exactly what it does before running it.
Does OrBase detect my language automatically?
No — OrBase never guesses. You tell it the language explicitly by writing --lang: <language> (for example --lang: python) at the top of your .orb file. The declaration decides which interpreter or compiler runs your code, which keeps execution predictable across all twelve languages.
How does a .orun know which .orb to run?
By name: a .orun only runs the .orb with the exact same name — cool.orun runs cool.orb, nothing else. When you open the .orun, OrBase saves a copy of your code to the temp folder, executes it, and deletes that temp copy right after, leaving nothing behind.
Do I need all twelve languages installed?
No. You only need the toolchains for the languages you actually declare with --lang:. If your .orun runs code whose compiler or interpreter is missing, OrBase asks you to download it.
Do I need VS Code?
Yes — .orb files open in Visual Studio Code, so you need it installed for editing to work out of the box. If you don't have (or don't want) VS Code, you can change which app opens .orb files in Windows Settings → Apps → Default apps.
How do compiled languages like Go, Rust and Java work?
The same way as everything else: declare --lang: go, --lang: rust or --lang: java at the top of the .orb file. When the .orun runs, OrBase invokes the matching toolchain — and asks you to download it if it isn't installed.
Does OrBase run in the background or collect data?
No. OrBase is a setup tool, not a resident program. Once the installer finishes, no OrBase process needs to run — Windows itself handles the launching via the Registry entries. There is no telemetry of any kind.
How do I uninstall or undo the associations?
OrBase ships a dedicated OrBaseUninstaller.pyw — download it from the repository and run it to remove the .orb / .orun associations. You can also reassign the file types yourself in Windows Settings → Apps → Default apps.
Where do I report a bug or request a language?
Open an issue on the GitHub issue tracker. Pull requests adding new language definitions are welcome.

Your scripts deserve a double-click.

Stop typing interpreter paths into a terminal for every quick script. Let the Registry do its job.