kivy / kivy-remote-shell

Remote SSH + Python interactive shell in Kivy

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-remote-shell's Issues

Use Buildozer

I recommend you provide instructions for using Buildozer instead of distribute.sh, it is much easier.

No example for using IR Blaster

ImportError: cannot import name 'manhole' from 'twisted.conch'

I am getting the following error while running the app in my mobile phone

11-17 23:22:05.021 21724 21761 I python : Traceback (most recent call last):
11-17 23:22:05.021 21724 21761 I python : File "/home/juan/git/kivy-remote-shell/.buildozer/android/app/main.py", line 12, in
11-17 23:22:05.022 21724 21761 I python : ImportError: cannot import name 'manhole' from 'twisted.conch' (unknown location)
11-17 23:22:05.022 21724 21761 I python : Python for android ended.

p4a build fails

I've tried to build kivy remote shell with kivy 1.10 and got the following error:
distutils.errors.DistutilsError: Could not find suitable distribution for Requirement.parse('cffi>=1.4.1')

I can install cffi 1.10 with pip, I think it is some dependency definition bug but have no idea how to fix it.
BR, Jacek

twisted.conch.error.ConchError: ('no host keys, failing', None)

Hey, built and executed from master, when running I get this error on startup:

I/python  ( 2166):  Traceback (most recent call last):
I/python  ( 2166):    File "/buildozer/.buildozer/android/app/main.py", line 73, in <module>
I/python  ( 2166):    File "/buildozer/.buildozer/android/platform/build/dists/remoteshell/private/lib/python2.7/site-packages/kivy/app.py", line 802, in run
I/python  ( 2166):    File "/buildozer/.buildozer/android/app/main.py", line 67, in build
I/python  ( 2166):    File "/buildozer/.buildozer/android/platform/build/dists/remoteshell/private/lib/python2.7/site-packages/twisted/internet/posixbase.py", line 495, in listenTCP
I/python  ( 2166):    File "/buildozer/.buildozer/android/platform/build/dists/remoteshell/private/lib/python2.7/site-packages/twisted/internet/tcp.py", line 998, in startListening
I/python  ( 2166):    File "/buildozer/.buildozer/android/platform/build/dists/remoteshell/private/lib/python2.7/site-packages/twisted/internet/protocol.py", line 77, in doStart
I/python  ( 2166):    File "/buildozer/.buildozer/android/platform/build/dists/remoteshell/private/lib/python2.7/site-packages/twisted/conch/ssh/factory.py", line 42, in startFactory
I/python  ( 2166):  twisted.conch.error.ConchError: ('no host keys, failing', None)
I/python  ( 2166): Python for android ended.```

Provide pre-built APK

A feature request of sorts. Can you provide, on the GitHub page, the Kivy Remote Shell APK? That or provide better build instructions as user support can be sparse.

Requiring users to build the APK presents a significant hurdle to gaining users. I spent 6 hours trying to get it built and never got a fully-functioning version. Fortunately, I stumbled on the APK and it worked immediately.

Update android app

Current android app has wrong permission which rectified by #18.

New app can be released using git release.

I can't download module 'fcntl'

Compile for android description is broken

executing "git clone git://github.com/kivy/kivy-remote-shell" as stated leads to:
The unauthenticated git protocol on port 9418 is no longer supported.

it should be: git clone https://github.com/kivy/kivy-remote-shell

Besides the fact that the precompiled link is broken as well, this makes it hard to get started

How do I build kivy-remote-app?

How do I do this when distribute.sh has become obsolete? I deleted buildozer.spec file which comes by default and I ran buildozer init command to get the new buildozer.spec file. After setting up the buildozer file and copy pasting the requirements and even downloading the requirement files individually, I still happen to run into errors.

Traceback (most recent call last):
  File "setup.py", line 90, in <module>
    setup(**params)
  File "/usr/lib/python2.7/distutils/core.py", line 151, in setup
    dist.run_commands()
  File "/usr/lib/python2.7/distutils/dist.py", line 953, in run_commands
    self.run_command(cmd)
  File "/usr/lib/python2.7/distutils/dist.py", line 972, in run_command
    cmd_obj.run()
  File "/usr/lib/python2.7/distutils/command/install.py", line 613, in run
    self.run_command(cmd_name)
  File "/usr/lib/python2.7/distutils/cmd.py", line 326, in run_command
    self.distribution.run_command(command)
  File "/usr/lib/python2.7/distutils/dist.py", line 972, in run_command
    cmd_obj.run()
  File "/usr/lib/python2.7/distutils/command/install_lib.py", line 101, in run
    self.byte_compile(outfiles)
  File "/usr/lib/python2.7/distutils/command/install_lib.py", line 142, in byte_compile
    verbose=self.verbose, dry_run=self.dry_run)
  File "/usr/lib/python2.7/distutils/util.py", line 385, in byte_compile
    from tempfile import mktemp
  File "/usr/lib/python2.7/tempfile.py", line 32, in <module>
    import io as _io
  File "/usr/lib/python2.7/io.py", line 51, in <module>
    import _io
ImportError: No module named _io
# Command failed: ./distribute.sh -m "pycrypto pyasn1 pyjnius twisted kivy" -d "remoteshell"
#
# Buildozer failed to execute the last command
# The error might be hidden in the log above this error
# Please read the full log, and search for it before
# raising an issue with buildozer itself.
# In case of a bug report, please add a full log with log_level = 2

Is there any file which forces buildozer to use .distribute.sh? Now keep in mind that I didn't setup python-for-android directory in buildozer.spec file. Is this forcing buildozer to download python-for-android's old toolchain while it says cloning from python-for-android?

If possible, can any one share their kivy-remote-shell app?

Updates to twisted means no longer works (errors out with no host key)

http://twistedmatrix.com/pipermail/twisted-python/2016-October/030819.html for reference. The following message in that thread is my workaround which seems to work.

Link to pre-built apk is broken

URL https://drive.google.com/open?id=0B1WO07-OL50_dzJDYU1Zak1WTnc returns 404

Cannot build on Ubuntu 14.04.1 LTS.

Fails to build using:
./distribute.sh -m 'openssl pycrypto pyasn1 pyjnius twisted kivy'

It gets to the pycrypto module but fails to build due to missing #include files.
For example:

compilation terminated.
In file included from cryptlib.c:117:0:
cryptlib.h:62:20: fatal error: stdlib.h: No such file or directory
#include <stdlib.h>

Any ideas?

Remote shell needs to be ported to iOS

Add a text editor to kivy remote shell

Freezing when calling another app

I downloaded the debug .apk, but I experience really weird behavior. On each webbrowser.open('tel://...') or tts.speak('hi') or anything else that can trigger something from outside to appear (dialer screen, tts options, etc), the shell freezes. But not in a casual way that you can easily press home button and stop it. No, the shell freezes everything (lockscreen works) and to exit it I need to hold power button until the menu pops out. Only then I'm able to press home button and later force stop the application.

Anything else that doesn't call another app (e.g. plyer.vibrator) works normally.

Samsung Galaxy Note 2, 4.4.2 stock

ImportError: No module named Cryopto

Such traceback:

01-24 12:11:25.127 18983 19269 I python  :  /data/user/0/org.kivy.remoteshell/files/app/lib/python2.7/site-packages/twisted/conch/ssh/common.py:18: RuntimeWarning: PyCrypto not installed, but continuing anyways!
01-24 12:11:25.149 18983 19269 I python  :  Traceback (most recent call last):
01-24 12:11:25.149 18983 19269 I python  :    File "/home/maho/workspace/sneak/kivy-remote-shell/.buildozer/android/app/main.py", line 12, in <module>
01-24 12:11:25.151 18983 19269 I python  :    File "/home/maho/workspace/sneak/kivy-remote-shell/.buildozer/android/platform/build/dists/remoteshell/private/lib/python2.7/site-packages/twisted/conch/manhole_ssh.py", line 14, in <module>
01-24 12:11:25.151 18983 19269 I python  :    File "/home/maho/workspace/sneak/kivy-remote-shell/.buildozer/android/platform/build/dists/remoteshell/private/lib/python2.7/site-packages/twisted/conch/ssh/factory.py", line 15, in <module>
01-24 12:11:25.153 18983 19269 I python  :    File "/home/maho/workspace/sneak/kivy-remote-shell/.buildozer/android/platform/build/dists/remoteshell/private/lib/python2.7/site-packages/twisted/conch/ssh/transport.py", line 22, in <module>
01-24 12:11:25.155 18983 19269 I python  :  ImportError: No module named Crypto
01-24 12:11:25.211 18983 19269 I python  : Python for android ended.

Code built in such way:

VERSION_twisted=15.4.0 buildozer --verbose android debug deploy run logcat

Error while trying to connect

Unable to negotiate with x.y.z.r: no matching key exchange method found.
Their offer: diffie-hellman-group1-sha1

buildozer.spec file has two [buildozer] sections

There is a small bug in the buildozer.spec file, it has two [buildozer] sections.

Run as a service under Android to avoid getting frozen

RIght now on Android, the ssh connection freezes if the user switches to another app, and returns to normal if the user switches back to kivy-remote-shell. To avoid such cases, Android provides the feature of Services, which is also available under python-for-android :
Services - python-for-android
Building a background application on android with Kivy.