kivy-reloader 0.1.1

No project description provided

kivy-reloader

Hot reload your Kivy app on multiple phones and computer in real-time.

This tool allows you to instantly update your Kivy app on multiple devices simultaneously by pressing Ctrl+S, saving your precious development time and effort.

How to use

from kivy_reloader import App

class MainApp(App):
    def build_and_reload(self, initialize_server=False, *args):
        from screens.main_screen import MainScreen

        return MainScreen(name="Main Screen")

MainApp()

https://github.com/kivy-school/kivy-reloader/assets/23220309/f1459d7e-ca53-4ed6-b4d1-980cdae4ce16

Prerequisites

Install scrcpy on your operating system: Linux, Windows or macOS. You will be able to control your device from your computer.

Install kivy: choose your operating system on Kivy School Tutorial.

Installing the project

Clone this project, open the folder on terminal and type:

1. poetry shell
2. poetry install

Configure the constants

Open the file constants.py and put the IP of your phone on the PHONE_IPS constant. You can find the IP of your Android phone on: Settings > About phone > Status > IP Address.

How to use:

1. Connect your phone to the computer using a USB cable.
2. Run on the terminal python compile_app.py, type 1 and press enter. Buildozer will compile the app and deploy on your phone.
3. Once the app is on your phone, run python main.py and the hot reload will be already working. Just press Ctrl+S in any file inside screens folder or main.py and your app will be updated on computer and phone at the same time.