kivy / kivy-launcher

Reboot of the older Kivy launcher

Kivy

Kivy is an open-source Python framework for developing GUI apps that work cross-platform, including desktop, mobile and embedded platforms.

The aim is to allow for quick and easy interaction design and rapid prototyping whilst making your code reusable and deployable: Innovative user interfaces made easy.

Kivy is written in Python and Cython and is built on OpenGL ES 2.0. It supports various input devices and has an extensive (and extensible) widget library. With the same codebase, you can target Windows, macOS, Linux (including Raspberry Pi OS), Android, and iOS. All Kivy widgets are built with multitouch support.

Kivy is MIT licensed, actively developed by a great community and is supported by many projects managed by the Kivy Organization.

Installation, Documentation and Examples

Extensive installation instructions as well as tutorials and general documentation, including an API reference, can be found at https://www.kivy.org/docs. A PDF version is also available.

Kivy ships with many examples which can be found in the examples folder.

Support

Are you having trouble using the Kivy framework, or any of its related projects? Is there an error you don’t understand? Are you trying to figure out how to use it? We have volunteers who can help!

The best channels to contact us for support are listed in the latest Contact Us document.

Contributing

We love pull requests and discussing novel ideas. Check out our latest contribution guide and feel free to improve Kivy.

It gives details of the best places online to discuss the development with the core developers and other enthusiasts.

Sibling projects

The Kivy team manager a number of additional projects that support the Kivy eco-system.

• Buildozer: a development tool for turning Python applications into binary packages ready for installation on any of a number of platforms, including mobile devices.
• Plyer: a platform-independent Python API for accessing hardware features of various platforms (Android, iOS, macOS, Linux and Windows).
• PyJNIus: a Python library for accessing Java classes using the Java Native Interface (JNI).
• Pyobjus: Python module for accessing Objective-C classes as Python classes using Objective-C runtime reflection.
• Python for Android: a development tool that packages Python apps into binaries that can run on Android devices.
• Kivy iOS: a toolchain to compile the necessary libraries for iOS to run Kivy applications, and manage the creation of Xcode projects.
• Audiostream: library for direct access to the microphone and speaker.
• KivEnt: entity-based game engine for Kivy.
• Oscpy: a Python implementation of Open Sound Control (OSC) network protocol.
• Garden: widgets and libraries created and maintained by users.

Licenses

• Kivy is released under the terms of the MIT License. Please refer to the LICENSE file.
• The provided fonts Roboto and Roboto Mono are licensed and distributed under the terms of the Apache License, Version 2.0. The DejaVuSans (used for the virtual keyboard) license can be viewed here.
• The current UI design has been adapted from Moblintouch theme's SVGs and is licensed under the terms of the LGPLv2.1.

Code of Conduct

In the interest of fostering an open and welcoming community, we as contributors and maintainers need to ensure participation in our project and our sister projects is a harassment-free and positive experience for everyone. It is vital that all interaction is conducted in a manner conveying respect, open-mindedness and gratitude.

Please consult the latest Code of Conduct.

Contributors

This project exists thanks to all the people who contribute. [Become a contributor].

Backers

Thank you to all of our backers! 🙏 [Become a backer]

Sponsors

Special thanks to all of our sponsors, past and present. Support this project by [becoming a sponsor].

Here are our top current sponsors. Please click through to see their websites, and support them as they support us.

kivy-launcher's Issues

ModuleNotFoundError: No module named 'jnius'

I just downloads the kivy launcher source code from here https://github.com/kivy/kivy-launcher
and I want to test on my pc but I get this error
it's possible to run it on the pc or I missing some things

C:\Users\husam\OneDrive\Desktop\Folders\kivy-launcher-master>python main.py
dispathc!
Traceback (most recent call last):
  File "main.py", line 31, in dispatch
    from jnius import autoclass
ModuleNotFoundError: No module named 'jnius'
[INFO   ] [Logger      ] Record log in C:\Users\husam\.kivy\logs\kivy_20-05-15_4.txt
[INFO   ] [deps        ] Successfully imported "kivy_deps.gstreamer" 0.1.18
[INFO   ] [deps        ] Successfully imported "kivy_deps.angle" 0.1.10
[INFO   ] [deps        ] Successfully imported "kivy_deps.glew" 0.1.12
[INFO   ] [deps        ] Successfully imported "kivy_deps.sdl2" 0.1.23
[INFO   ] [Kivy        ] v1.11.1
[INFO   ] [Kivy        ] Installed at "C:\Users\husam\AppData\Local\Programs\Python\Python37\lib\site-packages\kivy\__init__.py"
[INFO   ] [Python      ] v3.7.6 (tags/v3.7.6:43364a7ae0, Dec 19 2019, 00:42:30) [MSC v.1916 64 bit (AMD64)]
[INFO   ] [Python      ] Interpreter at "C:\Users\husam\AppData\Local\Programs\Python\Python37\python.exe"
[INFO   ] [Factory     ] 184 symbols loaded
[INFO   ] [Image       ] Providers: img_tex, img_dds, img_sdl2, img_gif (img_pil, img_ffpyplayer ignored)
start of log
 Traceback (most recent call last):
   File "main.py", line 62, in <module>
     dispatch()
   File "main.py", line 58, in dispatch
     run_launcher()
   File "main.py", line 17, in run_launcher
     Launcher().run()
   File "C:\Users\husam\AppData\Local\Programs\Python\Python37\lib\site-packages\kivy\app.py", line 829, in run
     root = self.build()
   File "C:\Users\husam\OneDrive\Desktop\Folders\kivy-launcher-master\launcher\app.py", line 188, in build
     from jnius import autoclass
 ModuleNotFoundError: No module named 'jnius'

How to try app with external packages??

Hi,

can someone tell me, how I should include external packeges for project??
For example in my app i want to use kivymd, pyjnius, etc.

Thanks for answering
Steve

New logo /icon

Hi, I am a graphic designer, I want to help others in graphic design.

After I reviewed your project, you have no logo on this project. Therefore I want to contribute to this project by creating a new logo / icon. what do you think?

Link to old kivy launcher somewhere

It's hard to find, and I'm trying to check what the situation is with included modules.

Screenshots

Kivy Launcher Stuck in Landscape Mode

I ran an application that uses landscape mode and now the launcher is stuck in landscape mode, even after closing the application completely.

kivy-launcher compiled with bulldozer will not run app.

I have an app that will run in ther version of kivy-launcher from the app store, but it will not run when I build kivy-launcher from source. kivy-launcher it's self does seem to run fine.

[Bug] Extra argument orientation passed in run_entrypoint function

Here: https://github.com/kivy/kivy-launcher/blob/master/main.py#L36
Quick fix: add an orientation=None keyword argument to the run_entrypoint function definition (and later use it if needed) or just don't pass the orientation anymore on the caller side.

To resolve errors executing actions

I would like to solve the actions error (below) in this repository.
What should I do?
Please give me some advice.

https://github.com/kivy/kivy-launcher/actions/runs/5143308636

Please generate the release apk file. Thank you

kivy-launcher doesn't detect landscape orientation

Describe the bug
kivy-launcher doesn't detect landscape orientation

To Reproduce
I used kivy-launcher version CI #18, since CI #19 crashes.
Put tablet (Android 13) in landscape orientation.
Start kivy-launcher version CI #18.
kivy-launcher starts in portrait orientation.

Expected behavior
kivy-launcher should detect the orientation. If kivy-launcher is started when tablet is in landscape orientation, then kivy-launcher should start in landscape orientation.

Logs/output
If applicable, add screenshots to help explain your problem.

Platform (please complete the following information):

• OS: [e.g. windows 10 /OSX 10.12 /linux/android 8/IOS 12…] = Android 13
• Python version. = 3.9.9
• release or git branch/commit = CI # 18
• git branch/commit url = https://github.com/kivy/kivy-launcher/actions/runs/3368775179
• git branch/commit artifact "package.zip" = https://github.com/kivy/kivy-launcher/suites/9065470017/artifacts/419416765

Additional context
Add any other context about the problem here.

How to install Kivy launcher in an android phone

Following the instructions of the "how it works" section in github, leads to the kivy documentation page (https://kivy.org/docs/guide/packaging-android.html#packaging-your-application-for-the-kivy-launcher) which leads to downloading the kivy launcher at google play store. Since kivy launcher is no longer available at google play store, it doesn´t help. There is an option for people that doesn't have access to the google play store (http://kivy.org/#download.) but it leads to a blank page. So I suggest you include installation instructions, so that we can install kivy launcher using the files provided at github, if possible.
Maybe the http://kivy.org/#download link should point to the installation page (https://kivy.org/doc/stable/gettingstarted/installation.html) where we can find a link to the python-for-android kivy version. But it is not clear that installing python-for-android is the same as installing the kivy launcher. If it is, I suggest you make that clear somewhere in the instructions.

No apps listed when run on Windows

I'm trying to test-run Kivy and the launcher on Windows, before going to Android.

• Installed Kivy as per instructions, including all dependencies
• installed kivy-launcher
• created android.txt in apps subdirectory of the kivy-launcher project root
• created a batch file that sets the environment variable:

set KIVYLAUNCHER_PATHS=/src/kivy-launcher/apps
main.py

However, still no apps are listed in the main launcher window. I've tried all possible versions of the path, like c:\src\kivy-launcher\apps, \src\kivy-launcher\apps, using the drive letter and different path separators.

Any help or expanding instructions would be helpful.

Thanks for resurrecting this project!

Apk problems with android

Describe the bug
Warning sign about android version

To Reproduce
Just open the application on the mobile

Expected behavior
Load the projects

Logs/output

Platform (please complete the following information):

• OS: android 12, MIUI 13.0.2
• 3.10
• 1.9.1.1

Issue with testing project in Kivy Launcher

I have been trying to test out many apps that I have made using kivy on my tablet (they all work on my computer).

I have connected my android tablet (Galaxy Tab-A) to the computer and have tried both of the following:

• Placed my project into /storage/emulated/0/kivy/
• Placed my project into /Card/kivy/

I have followed all of the instructions online regarding what to put in the android.txt file and how to copy things over but am still having nothing show up in the kivy launcher app.

Any help would be much appreciated, thank you!

Kivy Laucher closes when closing launcher app

Describe the bug
You can successfully open another app from the launcher but the launcher itself closes when this app calls app.close()

To Reproduce
Launch any of the apps here from the launcher (running from main as of creating this ticket) and then close them.
https://github.com/kivy/kivy-launcher/tree/rework/templates

Expected behavior
When closing a launched app, the launcher should re-appear.

Logs/output
The output is available here: https://gist.github.com/Zen-CODE/3a2b493ce8bef1731288222ea574cd67

Platform (please complete the following information):

• Android. Desktop platforms behave as expected.

Add prebuilt APKs

Could someone create a place to store some APKs built? Some people can't build it themselves and I was just hoping to install an APK instead of building one then installing it.

Add the app to F-droid repository

I suggest adding the app to F-droid repository. It's basically about having release tags, creating some metadata folders and updating change log.
I've recently experienced the process and I think it will be useful to have the App available on f-droid.

More information are available here:
https://f-droid.org/en/docs/Submitting_to_F-Droid_Quick_Start_Guide/

If you agree to have it on F-droid I may create some PRs to help with it.

Kivy App pulled from playstore

It seems the app was pulled from the play store, any plans on getting it back online

Issue while attempting to test project

Heya, i built the Kivy Launcher apk for arm64 (my phone is aarch64/arm64) and I've been unable to test my app, the GUI also doesn't scale wellx I've attached some images to show you.

How to use thins launcher on android

I'm trying to test an kivy app (coded in python3) and I can't use p4a for the moment (not working yet from my mac)
my app (main.py correctly works on my laptop and I want to test it on android
Any help would be appreciated

How this new kivy launcher should be use in android. Am I suppose to compile it (with buildozer or p4a ?)
Thanks in advance

Kaspersky for Android flagging Kivy-Launcher as a highly dangerous trojan

I have downloaded the Kivy Launcher latest build apk from the Actions section and installed on my Xiaomi RedMi Note 12. Before first execution Kaspersky Mobile jumped on me with a red screen talking about an extremely harmful trojan inside the App. I believe something is triggering this false alarm, but just in case i raised this issue here so you guys can comment on. Thanks!

Fresh build on of Launcher on Android shows no projects

OK... I installed Ubuntu 18.04.02 and followed instructions in Kivy 1.11.1 documentation

1. Install Kivy on Ubuntu
2. Clone this Kivy Launcher repository
3. Build and deploy with buildozer
4. Launcher runs on Android (great!)
5. No applications listed in display
6. No major errors I can find in logcat

When I run from the (python2) Play Store Kivy Launcher my app works. I had assumed that the new Kivy Launcher here would use the same directories do find projects and main.py files as the old one.

Thoughts?

the directory of the main.py(not Kivy Launcher's main.py) not in sys.path

Hi, 2 days ago I built a Kivy Launcher APK(python3crystax==3.5, kivy==master)and found a problem.

# main.py
import sys
import os.path

print(sys.path)
print(os.path.abspath('.'))

I placed main.py to /sdcard/kivy/test and ran.

# sys.path
.
/data/data/jp.gottadiveintopython.kivylauncher/files/app/crystax_python/stdlib.zip
/data/data/jp.gottadiveintopython.kivylauncher/files/app/crystax_python/modules
/data/data/jp.gottadiveintopython.kivylauncher/files/app/crystax_python/site-packages

# current directory
/data/data/jp.gottadiveintopython.kivylauncher/files/app

/sdcard/kivy/test not in sys.path so I wrote sys.path.append(os.path.dirname(__file__)) in main.py to avoid ImportError.

Also need fix

https://github.com/kivy/kivy-launcher/blob/master/main.py#L36
run_entrypoint(entrypoint, orientation=orientation) -> run_entrypoint(entrypoint)