{"id":15007203,"url":"https://github.com/os-1337/os1337","last_synced_at":"2025-10-30T11:31:29.455Z","repository":{"id":190329629,"uuid":"682389437","full_name":"OS-1337/OS1337","owner":"OS-1337","description":"OS/1337 Project ","archived":false,"fork":false,"pushed_at":"2024-11-24T21:23:24.000Z","size":18164,"stargazers_count":20,"open_issues_count":10,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T08:11:24.557Z","etag":null,"topics":["cli","desktop","distribution","embedded","embedded-linux","linux","linux-distribution","linux-distro","os-1337","os1337","retro","retrocomputing","server","terminal","tui"],"latest_commit_sha":null,"homepage":"https://os1337.com","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OS-1337.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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":"2023-08-24T04:22:52.000Z","updated_at":"2024-12-08T18:33:43.000Z","dependencies_parsed_at":"2023-12-27T18:28:14.308Z","dependency_job_id":"5a744284-8a9c-4645-9e1f-b7b8571550a5","html_url":"https://github.com/OS-1337/OS1337","commit_stats":null,"previous_names":["os-1337/os1337"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OS-1337%2FOS1337","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OS-1337%2FOS1337/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OS-1337%2FOS1337/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OS-1337%2FOS1337/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OS-1337","download_url":"https://codeload.github.com/OS-1337/OS1337/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238960353,"owners_count":19559248,"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":["cli","desktop","distribution","embedded","embedded-linux","linux","linux-distribution","linux-distro","os-1337","os1337","retro","retrocomputing","server","terminal","tui"],"created_at":"2024-09-24T19:05:27.285Z","updated_at":"2025-10-30T11:31:29.438Z","avatar_url":"https://github.com/OS-1337.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"#\tOS/1337\t\n### A minimalist yet useable, CLI-Oriented Toybox/Linux Distribution.\n##\n\n---\n\n### INDEX\n- #### [Getting Started](docu/internal/getting-started.md)\n- #### [Building OS/1337](docu/internal/building-packages.md)\n- #### [Project Goals](docu/internal/project-goals.md)\n- #### [Roadmap](docu/internal/roadmap.md) for OS/1337 development\n- #### [Acknowledgements](docu/internal/acknowledgements.md) of external helpers\n- #### [Further Sources](docu/internal/further-sources.md) to read into\n- #### [License](LICENSE.md)\n  - TLDR: It's [0BSD](https://en.wikipedia.org/wiki/BSD_licenses#0-clause_license_(%22BSD_Zero_Clause_License%22)) as created by Rob Landley [and used for toybox](http://www.landley.net/toybox/license.html).\n    - ###### Please note that [this does not apply to all parts of OS/1337 - notably the Linux Kernel!](LICENSE.md#important-note)\n\n---\n\n##\tCore Features\n### [TUI (GUI but in CLI!)](https://en.wikipedia.org/wiki/Text-based_user_interface) - based interface\n#### \"Make Terminals Great Again!\"\n80x25 terminal (per default) with options to even run in 80x24\n- 25th line is used as menu- / navigation- / statusbar\n  - as [customary from Terminals like the DEC VT320](https://youtu.be/RuZUPpmXfT0?t=208)\n####\n### Resource-Efficient\n#### \"Less is more!\"\n- Lack of X.org/Wayland/... and 'bloated' GUI apps per default make it extremely low-power friendly.\n- Can run on [extemely low powered systems]((https://en.wikipedia.org/wiki/Light-weight_Linux_distribution#Comparison)).\n  - [Can be run entirely from RAM](https://en.wikipedia.org/wiki/List_of_Linux_distributions_that_run_from_RAM)\n##\n\n---\n## [Roadmap](docu/internal/roadmap.md)\n#### OS/1337 is still in early development and has yet to make an initial release.\n\n--- \n## [Components](docu/ideas/components.md)\nBesides the basic core system, it's kept very lean just to enshure it's not bloated, with only concessions being made to reduce avoidable and burdensome inconveniences and incompatibilities.\n###\n\n### [Linux Kernel](https://kernel.org)\nSimply because a battle-tested, well maintained, versatile and with ample drivers equipped Kernel exists and rewriting it solely for the purpose of not using it is at best childish if not foolish. \n- OFC there are various other kernels that could also be used, like the ones of OpenBSD \u0026 FreeBSD or even Illumos [nee OpenSolaris] but that would just exceed the scope of this project. Feel free to DIY tho...\n  - Linux as a Kernel however has by far the most versatile support for architectures and hardware installed.\n###\n\n### [Toybox Userland](https://landley.net/toybox/)\nSimply because the absolute bare-minimum System should comfortably fit on a 1.440kB FDD.\n- Toybox also [includes the most essential functions and tools](https://landley.net/toybox/help.html) so the [bare minimum system is the Toybox binary](https://landley.net/toybox/faq.html#cross) + Kernel and C library. \n  - Not to mention [Toybox is easy to setup](https://landley.net/toybox/faq.html#install) [and build from scratch](https://landley.net/toybox/faq.html#mkroot), which is desireable for those wanting a system that can be audited at a lower cost. \n    - OFC one could use [BusyBox](https://www.busybox.net/) or even a *BSD [Userland](https://en.wikipedia.org/wiki/User_space_and_kernel_space) if they so desire...\n      - But that's NOT THE SCOPE OF THIS PROJECT!\n###\n\n### [musl C Library](https://musl.libc.org/)\nBecause [Glibc](https://en.wikipedia.org/wiki/Glibc) is a mess that tends to brick systems at the slightest minor version update, basically requiring recompilation or everything.\n- This is totally impractical for anyone having to work with [CCSS](https://en.wikipedia.org/wiki/Proprietary_software) aka. [Commercial Closed Source Software](https://en.wikipedia.org/wiki/Commercial_software) and thus only gets binaryblobs to execute.\n  - Also [uClibc](https://en.wikipedia.org/wiki/UClibc) and uClibc-ng are basically Abandonware at this point.\n###\n\n### [spm - Simple Package Manager](https://github.com/OS-1337/spm)\nAfter all, even a simplistic system should have the ability to install and uninstall applications.\n- It's very bare-bones, but it does it's job... \n  - And yes it's a fork of [SSPM](https://github.com/SuperSimplePackageManager/SSPM).\n###\n\n### [pkgs - Repository](https://github.com/OS-1337/pkgs)\nBecause a Package Manager without Repository is pretty much pointless.\n- Even tho it mostly contains just binaries to *yoink* and use.\n###\n\n### [default configurations](https://github.com/OS-1337/conf.d)\nTo allow for easier setup and customization...\n- Also helps finding misconfigurations.\n###\n\n### [sources links](https://github.com/OS-1337/dl.srcs.d)\nTo enable reproducible builds and spins.\n- Furthermore delivering transparency.\n\n---\n## [Project Goals](docu/internal/project-goals.md)\n\n##\tTarget Devices\n### [Supported Architectures are listed here.](./docu/ideas/architectures.tsv) \n- To be used on Systems that are being accessed via Terminals like:\n  - [DEC VT320](https://www.youtube.com/watch?v=RuZUPpmXfT0)\n  - [violence.works VT-69](https://www.youtube.com/watch?v=wYfpptgb6W8)\n- \"Slim Clients\"  \u0026 \"Thin Clients\"\n  - [hp t620](https://support.hp.com/us-en/document/c04017240)\n    - OFC that thin client is still fast enough to run BunsenLabs Linux and Tails but that doesn't mean it'll remain this way for very long...\n- Legacy Systems too slow or never designed to even run any fancy modern GUI that requires 3D acceleration\n  - [i486SX](https://en.wikipedia.org/wiki/I486SX) and up\n    - [Netbooks](https://en.wikipedia.org/wiki/Netbook)\n      - [Asus Eee Series](https://en.wikipedia.org/wiki/Asus_Eee_PC)\n        - [Eee PC 7xx](https://en.wikipedia.org/wiki/Asus_Eee_PC#Eee_700_series)\n          - Since it's the first Netbook and despite it's underwhelming hardware is still a good baseline.\n      - [VAIO P series](https://en.wikipedia.org/wiki/Sony_Vaio_P_series) \n        - [Sony VAIO P11Z](https://www.notebookcheck.net/Sony-Vaio-VGN-P11Z-G.14468.0.html) \n            - Mostly due to Intel's Fuckup that is the [GMA500](https://www.intel.com/content/www/us/en/support/products/81506/graphics/legacy-graphics/intel-graphics-media-accelerator-500-intel-gma-500.html) Onboard-GPU.\n      - [VIA OpenBook](https://en.wikipedia.org/wiki/VIA_OpenBook)\n  - entry level [amd64](https://en.wikipedia.org/wiki/X86-64) Devices\n    - [Intel Cherry Trail](https://ark.intel.com/content/www/us/en/ark/products/codename/46629/products-formerly-cherry-trail.html) based devices, like cheap entry-level Windows 8.x tablets and [*\"Stick PCs\"*](https://en.wikipedia.org/wiki/Stick_PC)...\n      - [Intel Compute Stick](https://en.wikipedia.org/wiki/Intel_Compute_Stick)\n      - [Dell Wyse 3040](https://www.dell.com/en-in/shop/business-pcs-desktop-computers/wyse-3040-thin-client/spd/wyse-3040-thin-client), cheap, compact, fanless and [power-efficient](https://www.storagereview.com/review/dell-wyse-3040-review) Thin Client that can be picked up very cheaply.\n- Select SoC's and Embedded as well as legacy devices.\n  - [Raspberry Pi Zero](https://www.raspberrypi.com/products/raspberry-pi-zero/) [W](https://www.raspberrypi.com/products/raspberry-pi-zero-w/)\n    - Simply because it's technically *\"the cheapest computer one can buy brand new\"* with an MSRP of $5(P i0)-$10(Pi0W) and because everything that runs on a [Pi0(W)](https://en.wikipedia.org/wiki/Raspberry_Pi#Specifications) shold also run on the Pi0W2 and any other Raspberry Pi SBC due to being backwards-compatible to the [ARMv6r11](https://en.wikipedia.org/wiki/ARM11#Chips) SoC being used.\n  - more depending on whether or not someone wants to build for and maintain them.\n    - A *\"generic ARM64+UEFI\"* image is desireable, but sadly hardware to test on is not available to the maintainers as of writing.\n\nIn theory it could also be used as a \"Rescue System\" or similar, but there are better tools out there like [Rescatux](https://www.supergrubdisk.org/rescatux/) and [Trinity Rescue Kit](https://trinityhome.org/).\n#### See [Project Goals](docu/internal/project-goals.md) for OS/1337\n##\n\n---\n##\tTarget Audience\n### Expedient Linux Users and *nix enthusiasts.\n#### This is basically [\"Hard Mode Linux\"](https://www.youtube.com/watch?v=_Ua-d9OeUOg\u0026t=117s) and if you're scared by looking at a terminal window or seeing someone using it, then you are NOT ALLOWED to use it!\nPlease realize that this isn't intended for people freshly switching to Linux.\n- Unless you have like decades of Unix Experience, this will be hard.\n  - Espechally since this is is an [Embedded Linux Distribution](https://en.wikipedia.org/wiki/Linux_on_embedded_systems), not a mainsteam distro, and is thus closer to [ELKS](https://en.wikipedia.org/wiki/Embeddable_Linux_Kernel_Subset) than Debian.\n\nSo please shift your expectation accordingly!\n\n### People who demand a tiny Linux distro that is yet still useable.\n#### DO NOT (!!!) expect The amount of Software and Support you'll find for [Ubuntu](https://ubuntu.com/) or any other mainsteam distro here.\nIf you just want a lightweight \u0026 Portable Desktop OS, consider [Tails](https://tails.net/), [BunsenLabs Linux](https://www.bunsenlabs.org/) or if you want something for guest and strangers to use, [Porteus Kiosk](https://porteus-kiosk.org/).\n- OS/1337 wants to make [TinyCore](http://www.tinycorelinux.net/) look \"phat\" in comparison.\n  - OFC this is achieved by virtue of sacrificing a Xorg/Wayland-based GUI!\n\n#### In fact, the \"core\" system is just [toybox](http://www.landley.net/toybox/)/[Linux](https://kernel.org) + [musl](https://musl.libc.org) with [dbclient](https://github.com/mkj/dropbear/blob/master/SMALL.md), the [SSH Client](https://en.wikipedia.org/wiki/Secure_Shell)-part of Dropbear.\n- The \"base\" system only adds [dropbear](https://github.com/mkj/dropbear), [enc](https://github.com/life4/enc), [ne](https://github.com/vigna/ne) and [nail](https://sourceforge.net/projects/nail/).\n- The \"main\" system offers [tmux](https://github.com/tmux/tmux), [curl](https://curl.se/download.html), [lynx](https://lynx.invisible-island.net), [aerc](https://git.sr.ht/~rjarry/aerc), [btop](https://github.com/aristocratos/btop), [mc](https://midnight-commander.org/), [aria2](https://github.com/aria2/aria2) on top of that.\n- The \"xtra\" system then includes all packages except \"servers\" and \"development tools\".\n##### A [list of all packages can be found here.](docu/pkgs/src.pkgs.list.tsv)\n \n### Counter-Indications\n#### Please refrain from using OS/1337 if you just want to \"Fuck Around and Find Out\"!\n###### This goes espechally to [Linus Sebastian of LinusTechTips](https://news.itsfoss.com/more-linux-distros-become-linus-proof/) who has weapons-grade [\"Tech-Illiteracy\"](https://www.youtube.com/watch?v=pYQtusd8deU) [unsarcastically!] and a [toxic followership](https://old.reddit.com/r/LinusTechTips/comments/t1e1if/you_destroyed_my_life/) to flex!\n#### OS/1337 is not a \"DOS\"!\n##### Not everything that has a Text Interface is an \"MS-DOS clone\"!\nYour experience with any *DOS won't help you here...\n###### [Please use FreeDOS instead.](https://www.freedos.org/)\n##\n\n---\n## [Acknowlegements](docu/internal/acknowledgements.md)\n\n### Name\n#### OS/1337 \nIt's a wordplay upon [OS/2](https://en.wikipedia.org/wiki/OS/2), [OS/360](https://en.wikipedia.org/wiki/OS/360_and_successors), [OS/390](https://en.wikipedia.org/wiki/OS/390) \u0026 [z/OS](https://en.wikipedia.org/wiki/Z/OS).\n- Naming it OS/3 or OS/420 was deemed too risky from a trademark standpoint, and one could reason it's meant to spread confusion among users of OS/2 or the OS/360 - z/OS family.\n  - Exacerbated by the fact that it's neither made nor endorsed by [IBM](https://en.wikipedia.org/wiki/IBM) and doesn't support the same [z/Architecture](https://en.wikipedia.org/wiki/Z/Architecture) as the aformentioned Mainframes.\n- It's a homage to old terminal Systems as well as to the clichee of \"Hackers\" that must always work with amber and/or green consoles on their ThinkPads and MacBooks wearing Fawkes Masks and black Hoodies.\n###\n\n### Inspirating Project\n#### [Floppinux](https://github.com/w84death/floppinux)\nFloppinux is a minimalist Linux distro designed to run from a single 3,5\", 1440 KB Floppy Disk.\n- It's based on BusyBox and a current Linux Kernel.\n  - But strips basically most of the unused features out of it.\n###\n\n---\n## \"Shut Up And Let Me Download!\"\n### \"Sharing is Caring\"\nReady-to-Use Binary Versions are [only distributed via magnet: links](https://en.wikipedia.org/wiki/Magnet_URI_scheme) over [BitTorrent](https://en.wikipedia.org/wiki/BitTorrent) in order to enshure resilient availability and speed for everyone.\n- Just use [Transmission](https://transmissionbt.com/) or [LibreTorrent](https://f-droid.org/en/packages/org.proninyaroslav.libretorrent/) for Downloading if you don't know how.\n  - If your ISP blocks BitTorrent get rid of your ISP or use a VPN.\n- Just don't be antisocial and use Tor to Torrent because all you'll do is exhaust valuable bandwith of exit nodes whilst compromizing your own anonymity.\n  - This is free software, not some pirated stuff!\n    - If you think BitTorrent has no \"legitimate use\" then you are banned from using OS/1337.\n  - Same goes for those that just download from the severely bandwith-restricted webseed and/or only leech the torrent.\n###\n\n### And before anyone asks:\n#### YES we are aware of [ClownFlare](https://en.wikipedia.org/wiki/Cloudflare#Kiwi_Farms) existing.\n  - [Liz Fong-Jones has done a pretty good 3 part explainer series why you should never use them at all](https://www.youtube.com/watch?v=Np9erdnM4l8\u0026list=PLI84-gNHkUdvE1u_Kfz3qS9h75n-m-T3y\u0026pp=iAQB) and in a way more concise and understandable form without ranting than I could do.\n    - After all, [the current maintainer](https://twitter.com/k3vk4/status/1562956359686971392) pushed for [#DropKiwifarms](https://github.com/greyhat-academy/lists.d#why-use-it) on other occasions.\n##### We won't solve scalability issues by creating de-facto monopolists or oligopolists!\n- Espechally if these are [knowingly and willingly supporting Terrorism by their own admission](https://en.wikipedia.org/wiki/Cloudflare#Terrorism)  and are [more part of the Problems than Solutions](https://en.wikipedia.org/wiki/Cloudflare#Crime).\n  - [\"Protecting the Good Guys for free\"](https://en.wikipedia.org/wiki/Cloudflare#Response_to_the_Russian_invasion_of_Ukraine) doesn't make said business less of a [protection racket](https://en.wikipedia.org/wiki/Protection_racket) as they knowingly and willingly also host [attackers wanting to extort others for ransom](https://en.wikipedia.org/wiki/Denial-of-service_attack#DDoS_extortion).\n###### Otherwise it would be pretty ridiculous to advocate for decentralization, multi-vendor \u0026 multi-provider solutions if not done so in real life, because one would otherwise [contribute to the increasing Enshittification of the the Internet](https://en.wikipedia.org/wiki/Enshittification).\n###\n\n---\n\n## [Further Reading](docu/internal/further-sources.md)\n\n## See Also:\n#### [Prof. Wim Vanderbauwhede](https://labs.ripe.net/author/anastasiya-pak/frugal-computing-for-a-sustainable-internet/)\n[Frugal Computing](https://arxiv.org/pdf/2303.06642v1.pdf)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fos-1337%2Fos1337","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fos-1337%2Fos1337","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fos-1337%2Fos1337/lists"}