DEV Community

AMZY31
AMZY31

Posted on

CharleX WebOS (Web-Based Operating system)

GitHub

πŸ–₯️ Charlex Web OS

A simple operating system as a webpage simulation. Built with Python 🐍 and Flask 🌐. Easy to use, open source, and focused on simplicity and libertarian-leftism. A simple UNIX web-based operating system with shell, created with love for the open-source GNU/Linux community!

Creator: Amin Azimi (AMZY31)

✨ Features

  • Free and open source πŸ“–
  • Web-based – no install needed 🌐
  • Simple and fast ⚑
  • Secure login and file storage πŸ”πŸ’Ύ
  • Built-in WebDisk for encrypted file management πŸ’Ύ
  • Interactive Shell Terminal for command execution πŸ–₯️
  • Network Tools for ping and status monitoring 🌐
  • System Monitor for CPU, memory, and disk usage πŸ“Š
  • Window-based desktop interface with drag, minimize, maximize πŸͺŸ
  • Dock with quick access to applications βš“
  • Easy to add new features 🧩
  • No hardware limitations – host your own customized Charlex WebOS 🌐
  • Enjoy network/web-based operating system πŸ–₯️
  • Store all files on network with sound good security πŸ”πŸ’Ύ
  • Delivered as open-source software πŸ“–
  • Libertarian-leftism principles πŸ•ŠοΈ

πŸ–₯️ Shell Terminal

The Charlex Web OS includes an interactive shell terminal accessible via the web UI. You can execute shell commands directly from the browser, view outputs, and manage command history. This feature allows for quick system interactions without leaving the application.

To use the shell terminal:

  1. Open the Shell Terminal window from the menu or dock.
  2. Enter commands in the input field and press Enter or click Execute.
  3. View the output in the terminal area.
  4. Use the Clear button to reset the output.

Note: Commands are executed on the server-side, so ensure proper security measures are in place for production use.

πŸ“‹ What You Need

  • Python 3.6 or newer 🐍
  • Flask (install with pip) 🌐

πŸš€ Get Started

  1. Create a virtual environment:
   python3 -m venv venv
   source venv/bin/activate  # Windows: venv\Scripts\activate
Enter fullscreen mode Exit fullscreen mode
  1. Install packages:
   pip install -r requirements.txt
Enter fullscreen mode Exit fullscreen mode
  1. Run the app:
   python app.py
Enter fullscreen mode Exit fullscreen mode
  1. Open http://localhost:5000 in your browser. πŸŽ‰

πŸ“ Project Files

  • app.py: Main app πŸ–₯️
  • models.py: Database stuff πŸ—„οΈ
  • webdisk.py: File storage πŸ’Ύ
  • ui_components.py: UI components and window management πŸͺŸ
  • shell.py: Shell terminal functionality πŸ–₯️
  • templates/: HTML pages 🎨
  • static/: CSS, JS, images πŸ“¦
  • requirements.txt: Needed packages πŸ“‹

🀝 Contributing

Fork the repo, make changes, and send a pull request. Keep it simple! πŸš€

πŸ“„ License

See LICENSE file. πŸ“œ

🎯 Why Charlex Web OS?

We believe in simplicity and libertarian-leftism. Avoids unnecessary complexity and restrictions. Users have full control over their experience. Inspired by free software and libertarian-leftism principles – freedom to use, modify, and share without limits. πŸ•ŠοΈ

License

This project is licensed under the terms specified in the LICENSE file.

CREATE BY :Amin Azimi (AMZY31)

Top comments (0)