https://github.com/aspinwall-ui/aspinwall-launcher
Launcher with a widget view for mobile Linux devices
https://github.com/aspinwall-ui/aspinwall-launcher
gtk linux ui
Last synced: 15 days ago
JSON representation
Launcher with a widget view for mobile Linux devices
- Host: GitHub
- URL: https://github.com/aspinwall-ui/aspinwall-launcher
- Owner: aspinwall-ui
- License: mit
- Created: 2021-12-28T20:33:46.000Z (over 3 years ago)
- Default Branch: develop
- Last Pushed: 2023-10-21T13:45:06.000Z (over 1 year ago)
- Last Synced: 2025-04-02T05:03:27.576Z (about 2 months ago)
- Topics: gtk, linux, ui
- Language: Python
- Homepage:
- Size: 4.83 MB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Aspinwall Launcher 
Smart display-esque launcher for mobile Linux
## About
The Aspinwall Launcher is a launcher for Linux devices. It shows the current time and date, as well as widgets selected by the user.
Widgets are written in Python and can be easily integrated with existing libraries.
## Installing
The project can be built and installed with Meson:
```shell
$ meson . build
$ meson compile -C build
$ sudo meson install -C build
```
For development purposes, the launcher can be started using the provided `./run` script.
Before you can use the `./run-*` scripts, you will need to install Meson.
## Requirements
### Runtime
- Python >= 3.8
- PyGObject
- GTK4 >= 4.8.0
- libadwaita >= 1.2.0
- GLib
### Build
These are also needed if you're planning to use the provided run scripts.
- meson
- glib2-dev or equivalent (needed for `glib-compile-schemas`)
- desktop-file-utils (needed for `update-desktop-database`)
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md).
We use [Hosted Weblate](https://hosted.weblate.org/projects/aspinwall-ui/) to manage translations. Built-in widget translations are split to their own sub-components; the translations can be found in the [Aspinwall Launcher](https://hosted.weblate.org/projects/aspinwall-ui/aspinwall-launcher/) component.