Skip to content

Bubble1296/BubbleOS

Repository files navigation

BubbleOS

Python Status Student Project Student Project Status Python

A desktop environment and OS simulator built with Python, Tkinter, and TkinterWeb.

About BubbleOS:

BubbleOS is a Python-based operating system simulator. It was created by Bubble12 and his friends as a fun project and to learn more about how to program in Python. It is intended to run alongside the host operating system on the user's machine in a separate window so that the user can switch between them. Please be patient for updates to roll out as this is being made in our free time. Thank you!

⚠️ BubbleOS is still under development and may contain bugs. ⚠️

System requirements:

  • Python 3
  • Tkinter
  • TkinterWeb

How to install and use BubbleOS:

Step 1: Download the desired version from the releases (easier method), OR, copy and paste the code from the repository page to your favorite Python compiler. Please note that you CANNOT use an online Python compiler for BubbleOS versions v1.0.0 and up due to the need of installing Tkinter, and BubbleOS versions v1.1.0 and up will require the addition of installing TkinterWeb. If you do not know how to do this, simply copy and paste the error message from the Terminal into your preferred AI assistant for help installing the missing libraries.

Step 2: Run BubbleOS for the first time. For LEGACY users (BubbleOS v0.2 and under), simply enjoy the simple CLI OS simulator. For MODERN users (BubbleOS v1.0.0 and up), run BubbleOS for the first time to get the error messages in your Terminal to determine what libraries are missing (see step 1 for more details). Install the missing libraries. Run BubbleOS for a second time and it should work.

Step 3: Feel free to give us suggestions and report bugs in the "Issues" tab, and please, feel free to share this project with your friends!

Versions:

  • BubbleOS Developer File.py is used for the developers only. They will upload their changes to GitHub.
  • BubbleOS Original.py is the very first and original file for BubbleOS. It is very simple and runs on a command line interface (CLI).
  • BubbleOS v0.1 RELEASE.py is the first "finished" file for BubbleOS.
  • BubbleOS v0.2 RELEASE.py is the second release file for BubbleOS. It consists of minor changes compared to v0.1.
  • BubbleOS v1.0.0 RELEASE.py NOT to be confused with v0.1. This major overhaul brought a proper clickable mouse UI, as well as a major rework on the system as a whole, including apps. Note the new file naming.
  • BubbleOS v1.1.0 RELEASE.py is an update to v1.0.0
  • BubbleOS v1.2.0 RELEASE.py is the first version of BubbleOS to receive an official word document processor app
  • BubbleOS v1.3.0 RELEASE.py FINALLY ADDED DRAGGABLE WINDOWS!!!

Current Features (v1.3.0):

  • Updated boot animation
  • Desktop environment
  • Taskbar
  • Web browser using TkinterWeb
  • DRAGGABLE WINDOWS!! No more pesky tabs!

What's coming up next?

  • BubbleOS v1.4.0 RELEASE.py is planned to be released relatively soon. It will consist of minor bug fixes, and hopefully a personalization update in the Settings app, among other things.
  • There is a known issue that is relatively minor, but to brand new users who do not have the required libraries installed for Python, including Tkinter, will receive an error message in their Terminal indicating that BubbleOS is calling for a missing library (usually Tkinter). We are working on making a screen that detects brand new users and asks them if they would like to install the missing libraries. However, this is not planned to be released in v1.4.0, and only in the near future if it is decided upon that it is necessary. (CURRENTLY NOT IN DEVELOPMENT)

Screenshots (BubbleOS v1.1.0):

Screen Shot 2026-03-10 at 10 03 56 PM Screen Shot 2026-03-10 at 10 04 03 PM Screen Shot 2026-03-10 at 10 02 43 PM Screen Shot 2026-03-10 at 10 03 35 PM Screen Shot 2026-03-10 at 10 03 25 PM Screen Shot 2026-03-10 at 10 03 17 PM Screen Shot 2026-03-10 at 10 03 11 PM Screen Shot 2026-03-10 at 10 03 02 PM Screen Shot 2026-03-10 at 10 02 54 PM

Thank you!

Bubble12

DISCLAIMER: Some code was assisted by Google Gemini AI, for educational purposes and bug fixes.