https://github.com/w3rr0/arduino-screen

A windowed application that allows you to display the most useful information on the Arduino screen when your main displays are occupied with other things. You decide what information to display, and you can change it whenever you need it.
https://github.com/w3rr0/arduino-screen

arduino cpp date lcd python qt time weather

Last synced: 3 months ago
JSON representation

A windowed application that allows you to display the most useful information on the Arduino screen when your main displays are occupied with other things. You decide what information to display, and you can change it whenever you need it.

• Host: GitHub
• URL: https://github.com/w3rr0/arduino-screen
• Owner: w3rr0
• License: mit
• Created: 2025-07-20T00:07:59.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-08-27T00:13:46.000Z (10 months ago)
• Last Synced: 2025-08-27T07:12:57.108Z (10 months ago)
• Topics: arduino, cpp, date, lcd, python, qt, time, weather
• Language: Python
• Homepage:
• Size: 932 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


[![MIT License][license-shield]][license-url]






  

    

  


  
Arduino Screen


  


    A window application to control the Arduino screen

    


    Report Bug

    ·

    Request Feature

  



  Table of Contents

  


    


      About The Project

      


        
Built With

      

    

    


      Getting Started

      


        
Prerequisites

        
Installation

      

    

    
Usage

    
Contributing

    
License

    
Contact

  


## About The Project







A windowed application that allows you to display the most useful information on the Arduino screen when your main displays are occupied with other things.

The compact size of this screen allows you to place it in the most convenient location, such as under the monitor or above the keyboard.

You decide what information to display, and you can change it whenever you need it.

Options that can be displayed:

- Time

- Date

- Weather

- RAM Usage

- RAM Available

- CPU Usage

- Network

(back to top)


### Built With

The following tools were used to build the application:

- Aplikacja okienkowa:

  - Qt for Python (PySide 6)

  - Qt Creator (UI)

- Program na arduino:

  - .ino (C++)

(back to top)


## Getting Started

To get started, you'll need the appropriate version of Python, the necessary dependencies, and an Arduino coding program installed.

I also recommend Qt Creator as an IDE and Qt Designer for UI development, but they're not essential.

### Prerequisites

Before you start working, connect the I2C LCD display (2x16) to the Arduino and then the whole thing via a USB cable to the computer.

Install Arduino IDE from the [official website](https://www.arduino.cc/en/software).

Then use it to upload [arduino-screen.ino](http://www.github.com/w3rr0/Arduino-screen/arduino-screen.ino) to your arduino.

### Installation

* python 3.9.6

  ```sh

  python3.9 --version

  ```

  If you don't have this version, install it.

* project files

  ```sh

  git clone https://github.com/w3rr0/Arduino-screen.git

  cd Arduino-screen

  ```

* virtual environment

  ```sh

  python3.9 -m venv .venv

  ```

  * Linux/Mac

    ```sh

    source .venv/bin/activate

    ```

  * Windows (cmd)

    ```sh

    .venv\Scripts\activate

    ```

  * Windows (PowerShell)

    ```sh

    .\.venv\Scripts\Activate.ps1

    ```

* requirements

  ```sh

  pip install -r requirements.txt

  ```

(back to top)


## Usage

You can run the program from Qt Creator (green play icon) or simply run the widget.py file in Python.

First, you select a device from the list of available ports, select the information you want to display, and click Display.

Your Arduino screen should now show the content you selected.

(back to top)


## Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request.

You can also simply open an issue with the tag "enhancement".

1. Fork the Project

2. Create your Feature Branch (`git checkout -b main/NewFeature`)

3. Commit your Changes (`git commit -m 'Add NewFeature'`)

4. Push to the Branch (`git push origin main/NewFeature`)

5. Open a Pull Request

(back to top)


## License

Distributed under the MIT License. See `LICENSE.txt` for more information.

(back to top)


## Contact

Konrad Mateja - konradmateja65@gmail.com

Project Link: [https://github.com/w3rr0/Arduino-screen](https://github.com/w3rr0/Arduino-screen)

(back to top)


[license-shield]: https://img.shields.io/github/license/w3rr0/Arduino-screen.svg?style=for-the-badge

[license-url]: https://github.com/w3rr0/Arduino-screen/LICENSE.txt