Skip to content

JappeOS/jappeos_services

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


jappeos_services

A service system that allows easy access to the jappeos_core systemd service using D-Bus.


Overview

jappeos_services makes it easy to access things like the audio system in an unified way, regardless of the actual backend (e.g. pipewire, pulseaudio, etc.). This means that the backend can be easily swapped from pipewire to pulseaudio for example.

This system is used in the JappeOS desktop environment to control system volume, connect to the internet, use the Bluetooth and more. It is also used by the applications that need access to the system, like the settings app.

This is used just like a regular provider in Flutter, using the provider package. Use the JappeosServiceProvider widget to register the services, and then use them like any other provider in your widgets.

Other non-JappeOS apps that use the underlying APIs (e.g. pulseaudio) directly will still work, but swapping the backend might break them.

Warning

This package is designed to work on Linux, and is not supposed to be used on any other platform.

Features

  • Access to all jappeos_core D-Bus services.

Role in the OS

Used by all Dart-written components of JappeOS that require access to system things like power management, networking, login, sessions etc. The greeter and the desktop environment use this.

Building

Compiles like a regular Dart project. Used as a library through pubspec. Not meant to be directly compiled.

Contributing

Contributions of all kinds are welcome and appreciated. You can help the project by:

  • ⭐ Starring the repository to show your support
  • 💖 Sponsoring the project (if available)
  • 🐞 Reporting bugs via GitHub Issues
  • 💡 Requesting or discussing new features

For code contributions, please see CONTRIBUTING.md for guidelines.

License

This repository is part of the JappeOS project and is licensed under the terms described in the LICENSE file.

About

A Flutter service system providing access to the session manager, WiFi, Bluetooth and more.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages