https://github.com/tsbarnes/pitftmanager
Display manager for framebuffer devices (like the PiTFT) on Raspberry Pi
https://github.com/tsbarnes/pitftmanager
adafruit archlinuxarm fortune-cookies framebuffer pitft python python3 raspberry-pi raspberrypi system-information
Last synced: 5 months ago
JSON representation
Display manager for framebuffer devices (like the PiTFT) on Raspberry Pi
- Host: GitHub
- URL: https://github.com/tsbarnes/pitftmanager
- Owner: tsbarnes
- Created: 2021-09-11T03:53:47.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2022-08-07T00:55:28.000Z (about 3 years ago)
- Last Synced: 2025-04-04T08:02:06.134Z (6 months ago)
- Topics: adafruit, archlinuxarm, fortune-cookies, framebuffer, pitft, python, python3, raspberry-pi, raspberrypi, system-information
- Language: Python
- Homepage:
- Size: 448 KB
- Stars: 2
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# PiTFT Manager
Display manager for framebuffer devices (like the PiTFT) on Raspberry Pi.
## What's a display manager?
Simply put, a display manager is an application that provides other applications with access to the display.
In practice, this means you can create your own apps for it, switch between apps on the fly, and more!
## Why PiTFT?
The Adafruit PiTFT 3.5" is what I'm developing it on/for, so I chose to reference it in the name.
## What apps come with it?
* `dashboard` - displays weather, next calendar event, and next task due
* `system` - displays system information
* `fortune` - displays fortune cookies
* Note: requires `fortune-mod` to be installed!
* `affirmations` - displays positive affirmations
* `calendar` and `tasks` - display events/tasks from webcal and caldav calendars
* `weather` - displays the current weather
## Creating apps
Creating apps is simple, each app is a Python module that provides an `App` class,
which should inherit from the `apps.AbstractApp` class. Then you just need to implement
the `run_iteration` method and have it do whatever you want the app to do!
More documentation for development coming soon.
## Installation
* First, clone the repository onto the Raspberry Pi, I recommend cloning it to `~/pitftmanager` and then change directory into it.
* Second, install the required Python libraries.
* Third, copy the `pitftmanager.service` file into `/etc/systemd/system`.
* Fourth, edit the path in `/etc/systemd/system/pitftmanager.service` to the path where you checked out the code
* Fifth, enable the `systemd` service.
* Lastly, start the `systemd` service, or reboot.
Quick command list to install:
```shell
git clone https://github.com/tsbarnes/pitftmanager.git ~/pitftmanager
cd ~/pitftmanager
sudo pip3 install -r requirements.txt
sudo cp ~/pitftmanager/pitftmanager.service /etc/systemd/system/
sudo nano /etc/systemd/system/pitftmanager.service # don't forget to change the path!
sudo systemctl daemon-reload
sudo systemctl enable pitftmanager
sudo systemctl start pitftmanager
```