Operating System (OS)

OS is the Motanamy Electron desktop window platform. Each OS plugin runs as its own standalone window with a custom title bar and toolbar. Plugins have full control over their UI and navigate internally with their own router — completely isolated from the SA/EA host.

How Plugins Work

OS loads each installed plugin's script.js. Your script calls methods on this to configure the window frame, toolbar, translations, and page routes:

plugins["my-plugin"] = function () {
    this.setFrame({
        title: "Motanamy OS | My Plugin",
        icon: { type: "icon", name: "mdi mdi-puzzle-outline" }
    });

    this.addLanguage("en", "my-plugin", { name: "My Plugin" });

    this.setToolbar([
        { icon: "pi pi-cog", to: "/setting" }
    ]);

    this.addPage({
        name: "/[my-plugin]index.vue",
        path: "",
        file: ["index.vue"]
    });

    this.addPage({
        name: "/[my-plugin]setting.vue",
        path: "/setting",
        file: ["setting.vue"]
    });
}

Key Differences from EA and SA

	OS	SA	EA
Window	Own Electron window	Embedded in SA host	Browser tab
Main view	index.vue	widget.vue	widget.vue
Navigation	Root paths ("", "/setting")	/app/... paths	/app/... paths
File dialogs	ipcRenderer from electron	EventBus openFileExplorer	EventBus openFileExplorer
Backend	None	None	main.js
Database	api.database() (local)	api.database() (local)	app.database() via HTTP
Roles	No	No	Yes
Toolbar	setToolbar()	—	addToToolbar()
Frame	setFrame()	—	—

Tech Stack

Layer	Technology
Runtime	Electron
UI Framework	Vue 3
Component Library	PrimeVue v3
CSS Utilities	PrimeFlex
Icons	PrimeIcons + MDI
Database	Local JSON via api module
Native Dialogs	ipcRenderer from electron

Quick Start

1. Install Motanamy OS — wget -O - https://app.motanamy.com/MotanamyOS.sh | bash
2. Install the CLI — npm install -g motanamy-cli
3. Create the plugin folder structure (see Development Guide)
4. Write setting.json and script.js
5. Run mot run to link your plugin to a running OS instance

Resources

• Development Guide
• script.js API Reference
• Example Plugin