An open API service indexing awesome lists of open source software.

https://github.com/reset171/renplay


https://github.com/reset171/renplay

android android-app emulator jetpack-compose kotlin launcher material-you renpy visual-novel

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

          

# RenPlay

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![API](https://img.shields.io/badge/API-28%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=28)

Android-лаунчер для запуска визуальных новелл на движке [Ren'Py](https://www.renpy.org/). Позволяет устанавливать разные версии движка в виде плагинов и запускать игры напрямую из директорий во внутренней памяти устройства.

## Возможности
* Поддержка нескольких версий Ren'Py (установка движков из `.zip` архивов).
* Статистика игрового времени.
* Создание ярлыков игр на главном экране.

## Скриншоты





## Установка
APK файлы приложения и архивы с плагинами нужных версий движка доступны на странице [Releases](https://github.com/Reset171/RenPlay/releases).

## Использование
1. Откройте приложение и предоставьте разрешение на доступ к файлам.
2. Перейдите в «Настройки -> Управление версиями Ren'Py» и установите нужную версию движка, выбрав загруженный `.zip` архив.
3. Скопируйте папку с игрой (ПК версии) во внутреннюю память устройства. Убедитесь, что внутри нее находится подпапка `game`.
4. Нажмите кнопку `+` на главном экране, найдите папку с игрой в списке и нажмите на неё.
5. Приложение автоматически попытается определить название, версию, иконку и нужный движок из файлов игры. Вы можете отредактировать их перед добавлением в библиотеку.

## Сборка
Для самостоятельной сборки потребуется JDK 21 и Android SDK (API 34).

1. Клонируйте репозиторий:
```bash
git clone https://github.com/Reset171/RenPlay.git
```
2. Для загрузки UI-библиотек (OneUI Design и SESL) требуется авторизация в GitHub Packages. Создайте Personal Access Token (classic) с правом `read:packages`.
3. Создайте файл `local.properties` в корне проекта и добавьте ваши данные:
```properties
github.user=Ваш_Логин_GitHub
github.token=Ваш_Сгенерированный_Токен
```
4. Создайте файл конфигурации ключей `key.properties` в корне проекта. Для тестовой сборки достаточно указать заглушки:
```properties
keyAlias=debug
keyPassword=debug
storePassword=debug
storeFile=debug.keystore
```
5. Запустите сборку:
```bash
./gradlew assembleDebug
```

## О разработке
Автор данного проекта не является программистом. Вся кодовая база, архитектура приложения и интеграция библиотек были созданы с активным использованием искусственного интеллекта.

## Лицензия
Проект распространяется под лицензией [GPLv3](LICENSE).
В приложении используются сторонние компоненты (SDL2, Python, Ren'Py и др.), их лицензии указаны в разделе "О программе" внутри приложения.