Skip to main content

Android's SystemFileChooser with Kivy

A tool that uses Android's SystemFileChooser to process materials with the set of tools from Kivy.

Buildozer

To include these tools with Buildozer just include androidssystemfilechooser in the requirements.

API

For now it's better if you just read the source/code.
JavaStream(input_stream)
SystemFileChooser(mime_type, multiple)
uri_to_extension(uri)
uri_to_filename(uri)
uri_to_stream(uri)
uri_image_to_texture(uri)

Permissions and Runtime-permissions

You don't have to state anything.

Example code of use

from androidssystemfilechooser import (SystemFileChooser,
                                       uri_image_to_texture,
                                       uri_to_extension,
                                       uri_to_stream)
from kivy.app import App
from kivy.core.image import Image as CoreImage
from kivy.lang import Builder
from kivy.properties import StringProperty
from kivy.uix.button import Button
from kivy.uix.image import Image

KV = '''
BoxLayout:
    orientation: 'vertical'

    MyTriggerButton:
        multiple: True
        text: 'Choose and execute results!'
        on_release: self.trigger()
'''


class MyTriggerButton(SystemFileChooser, Button):
    mime_type = StringProperty('image/*')

    def on_uris(self, instance, uris):
        for nr, uri in enumerate(uris):
            if nr % 2 == 0:
                with uri_to_stream(uri) as stream:
                    image = CoreImage(stream, ext=uri_to_extension(uri))
                texture = image.texture
            else:
                texture = uri_image_to_texture(uri)
            instance.parent.add_widget(Image(texture=texture))
        self.uris = []


class MyApp(App):
    def build(self):
        return Builder.load_string(KV)


if __name__ == '__main__':
    MyApp().run()

License

MIT-Licensed.

Metadata

Release files for AndroidsSystemFileChooser 1.11

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for AndroidsSystemFileChooser 1.11
File Size Uploaded
androidssystemfilechooser-1.11.tar.gz 4.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for AndroidsSystemFileChooser 1.11
File Interpreter ABI Platform
androidssystemfilechooser-1.11-py3-none-any.whl Python 3 none any Details

Total release size: 10.5 kB

Release files / androidssystemfilechooser-1.11.tar.gz

Download URL androidssystemfilechooser-1.11.tar.gz
Size 4.8 kB
Tags Source
SHA-256 checksum
How to use checksums
3d8b293500b34d25aafcc26e03a3b57b8686557363537a79154429b09c7e8e5a
BLAKE2b-256 checksum
How to use checksums
396554fb4fc882048693d9b635b29156f1382b9cfa53e8cffca63b28a3f7c41d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 3, 2026.

Transparency log

Release files / androidssystemfilechooser-1.11-py3-none-any.whl

Download URL androidssystemfilechooser-1.11-py3-none-any.whl
Size 5.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fcfb390e3bf8b79f48e712b686cb275cb3f3c8dcabd1b307efd092cb4bc23783
BLAKE2b-256 checksum
How to use checksums
6c3c507f5618b5227d56bc21cf8b51449018431099d750dfd501a6b4c4ba2bb6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Aug 3, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

1.11 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page