{"id":26136207,"url":"https://github.com/azusystem/azuos","last_synced_at":"2025-04-13T22:52:45.263Z","repository":{"id":244318898,"uuid":"813889814","full_name":"AzuSystem/AzuOS","owner":"AzuSystem","description":"If it runs on the Web, it runs on AzuOS","archived":false,"fork":false,"pushed_at":"2025-03-09T18:27:48.000Z","size":51029,"stargazers_count":8,"open_issues_count":1,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T13:11:22.982Z","etag":null,"topics":["azuos","desktop-environment","foss","html","html-css-javascript","javascript","js","linux","linux-desktop","no-electron","no-nodejs","operating-system","os","project","python","pywebview","web-based","web-desktop","web-os","web-technologies"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AzuSystem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-12T00:07:08.000Z","updated_at":"2025-03-09T18:50:44.000Z","dependencies_parsed_at":null,"dependency_job_id":"a3e6c1f7-8eeb-4450-b311-9062cc03d279","html_url":"https://github.com/AzuSystem/AzuOS","commit_stats":null,"previous_names":["azusystem/azuos"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzuSystem%2FAzuOS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzuSystem%2FAzuOS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzuSystem%2FAzuOS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AzuSystem%2FAzuOS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AzuSystem","download_url":"https://codeload.github.com/AzuSystem/AzuOS/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248794568,"owners_count":21162614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["azuos","desktop-environment","foss","html","html-css-javascript","javascript","js","linux","linux-desktop","no-electron","no-nodejs","operating-system","os","project","python","pywebview","web-based","web-desktop","web-os","web-technologies"],"created_at":"2025-03-11T00:56:51.086Z","updated_at":"2025-04-13T22:52:45.239Z","avatar_url":"https://github.com/AzuSystem.png","language":"JavaScript","readme":"\u003cdiv align=\"center\"\u003e\n \u003cimg width=\"120\" alt=\"AzuOS: If it runs on the Web, it runs on AzuOS\" src=\"assets/logo.svg\"\u003e\n\t\u003ch1\u003eAzuOS\u003c/h1\u003e\n\t\u003cp\u003eAzuOS is an Arch-based Operating System featuring a Desktop Environment written with Web Technologies and a Python Backend.\u003c/p\u003e\n\t\u003ca href='https://azusystem.github.io/AzuOS'\u003eTry out a live demo ↗\u003c/a\u003e\n\u003c/div\u003e\n\n## 👀 What does AzuOS offer?\nAn advantage of AzuOS being built on Web Technologies is it allows users and developers to easily customize their system and make it their own.\nFrom a simple change in a theme file, to replacing a css file, to literally writing your own desktop script.\n\nAll that is required for developers is experience with Vanilla Javascript and you're good to go 👍\n\n## 🧐 Why?\nI know... it seems weird having a Desktop Environment based on Javascript and Python and this alone is enough to drive some people away, which is understandable.\nA Web-Based Desktop makes development faster and easier, even for those just forking the project. Although admittedly, a desktop not written primarily with such languages is better.\n\n## 🔧 What does AzuOS run on?\nAzuOS is built using Javascript \u0026 Python, however runs on top of [Arch Linux](https://archlinux.org).\n\nTheoretically, AzuOS can run on other linux systems, assuming they also use bash, you may need to replace some shell scripts with ones that work on your linux distro of choice.\n\nFreeBSD could probably work too, although shell scripts may require rewriting too.\n\n## 💻 Getting Started\nIf you're interested in contributing to AzuOS or forking the project, you first need to setup up your workspace!\n\n***Disclaimer: AzuOS is primarily designed for Unix-like platforms, such as Linux or BSD. It is not guaranteed to work on Windows due to compatibility issues. If you encounter problems, we encourage you to contribute a fix or seek community support. However, do not make a GitHub Issue about incompatibility for Windows.***\n\nSo here's how:\n\nFirst confirm you have `git`, `python3`, `python3-pip` and `xorg`\n\n### Installing Git\n\nMake sure you have `git` installed, this will allow you to fetch the latest AzuOS source directly from GitHub\n\nGit for Debian/Ubuntu (Debian-based distros):\n\n```bash\nsudo apt install git-all\n```\n\nGit for Arch Linux:\n\n```bash\nsudo pacman -S git\n```\n\nGit for Windows: \n\n\u003e There are also a few ways to install Git on Windows. The most official build is available for download on the Git website. Just go to https://git-scm.com/download/win\n\u003e and the download will start automatically. Note that this is a project called Git for Windows, which is separate from Git itself; for more information on it,\n\u003e go to https://gitforwindows.org.\n\n_Source: [Getting Started: Installing Git (git-scm.com)](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)_\n\nGit for MacOS:\n\n\u003e There are several ways to install Git on macOS. The easiest is probably to install the Xcode Command Line Tools. On Mavericks (10.9) or above you can do this simply by trying to run git from the Terminal the very first time.\n\n```bash\n$ git --version\n```\n\n\u003e If you don’t have it installed already, it will prompt you to install it.\n\n\u003e If you want a more up to date version, you can also install it via a binary installer. A macOS Git installer is maintained and available for download at the Git website, at https://git-scm.com/download/mac.\n\n_Source: [Getting Started: Installing Git (git-scm.com)](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)_\n\nIf your operating system of choice isn't listed, please do research on installing git for said system.\n\nAfter installing `git`, to download AzuOS, run\n\n```bash\ngit clone https://github.com/AzuSystem/AzuOS {directory of choice}\ncd {directory of choice}\n```\n\nIt is recommended that you clone this repo into /azuos, although you'll likely need to use sudo to do so.\n\n### Python 3\nNow for python, which is required for initialising AzuOS, and uh, we won't be using [electron](https://electronjs.org) anytime soon.\n\nPython for Debian/Ubuntu (Debian-based distros):\n\n```bash\nsudo apt install python3 python3-pip\n```\n\nPython for Arch Linux:\n\n```bash\nsudo pacman -S python python-pip\n```\n\nPython Installer for Windows (Don't forget to install with pip!): \nhttps://www.python.org/downloads/windows/\n\nPython Installer for MacOS (Don't forget to install with pip!): \nhttps://www.python.org/downloads/macos/\n\nIf your operating system of choice isn't listed, please do research on installing Python 3 and PIP for Python for said system.\n\n### Python Libaries\nOnce python and pip have been installed, we need to install a few modules\n\nThis command in most cases, should be universal across operating systems, if it doesn't work, you may need to google for solutions :'(\n\n```bash\npip install pywebview psutil py-cpuinfo\n```\n\n### X11 Server\nAzuOS runs on X.org in a live ISO.\n\nIf you wanna try running AzuOS via X.org, you'll need to install it first.\nIf you're a Windows/MacOS user, don't worry about this :3\n\n\nXorg for Debian/Ubuntu (Debian-based distros):\n\n```bash\nsudo apt install xorg\n```\n\nXorg for Arch Linux:\n\n```bash\nsudo pacman -S xorg\n```\n\nAfter installing, somewhere in your home directory (/home/username or ~/) you'll find `.xinitrc`\n\nOpen/create this file in a text editor of your choice (i'll use vim)\n\n```bash\nsudo vim ./.xinitrc\n```\n\nAnd write\n\n```bash\npython {azuos directory}\n```\n\nAnd save\n\n```bash\n:wq\n```\n\nAfterwards, if you wanna start X server with AzuOS running, just run\n\n```bash\nstartx\n```\n\n## 💜 Backstory\nI (MTSyntho), come from a background of making OS Concepts using Windows Batch Scripting and Microsoft PowerPoint.\n\nNone of my creations were any good but I enjoyed making them either way, since those days it's been my dream to make my own functional OS to some degree.\n\nAnd now 3 years later, in 2024, we have AzuOS, i'll never forget those amazing days ❤️\n\n_p.s azuos doesnt need a web server to run, running the html page directly works pretty well :3_","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazusystem%2Fazuos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazusystem%2Fazuos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazusystem%2Fazuos/lists"}