https://github.com/tshirtman/kivy_service_osc

simple UI/Service communication using osc on python-for-android
https://github.com/tshirtman/kivy_service_osc

android example kivy osc python service

Last synced: 2 months ago
JSON representation

simple UI/Service communication using osc on python-for-android

• Host: GitHub
• URL: https://github.com/tshirtman/kivy_service_osc
• Owner: tshirtman
• License: mit
• Created: 2013-12-17T23:49:50.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2023-01-30T13:39:56.000Z (almost 2 years ago)
• Last Synced: 2024-10-15T06:23:02.072Z (2 months ago)
• Topics: android, example, kivy, osc, python, service
• Language: Python
• Size: 33.2 KB
• Stars: 61
• Watchers: 7
• Forks: 21
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
Purpose

=======

[![CircleCI](https://circleci.com/gh/tshirtman/kivy_service_osc/tree/master.svg?style=svg)](https://circleci.com/gh/tshirtman/kivy_service_osc/tree/master)

This code aims at demonstrating an use of services in python-for-android, and

communication between services and a kivy front end.

That examples uses the OSC protocol for simplicity and historical reasons,

(since an implementation was shipped with kivy historically, and a better one

is now found in `oscpy`). The OSC protocol makes things simple because

it's unconnected, you just send a message, and can forget about it. You bind

functions to messages you receive. It's simple enough for a lot of things, and

avoids the burden of maintaining a connection when both the service and front

end can be restarted any time.

The app is composed of the front-end, defined in src/main.py, and the back-end defined in src/service.py.

The service (back-end):

  - is defined in buildozer.spec, in the `services` line. Following the example syntax

  - is started by the application at startup time, and can be stopped/restarted from the UI.

  - sends the current date, as a string, every tenth of a second to the UI, on a '/date' address.

  - answers with a random string on the '/message' address when a message is sent to the '/ping' address on its side.

The UI (front-end):

  - is defined in main.py

  - allows stopping/restarting the backend.

  - displays the last received messages from the backend in a RecycleView

  - allow to sent a '/ping' message to the backend, which will trigger a new message.

Building:

  - The package is built using CircleCI, you should be able to download the

    latest debug apk by clicking on the "Artifacts" tab on the latest build.

  - This project is a template repository, so you can create your own project

    from it, and setup CircleCI to build your version of it.

  - You can also just run the `kivy/buildozer` docker image to build your project from any Linux computer.

  ```

  docker run -v $PWD:/project/ -w /project/ kivy/buildozer android debug

  ```

  Once it's completed, you should have a bin/ directory with the apk inside.