From 4006a3a2c59a8f42785a2b50dfa8bc066fc38d2c Mon Sep 17 00:00:00 2001 From: Andrey Prokopyuk Date: Thu, 15 Oct 2026 13:26:35 +0300 Subject: [PATCH 1/2] docs: add F-Droid installation instructions --- AGENTS.md | 3 ++- README.md | 4 ++-- docs/en/installation.md | 19 +++++++++++++++++-- docs/en/updates.md | 2 +- docs/ru/installation.md | 21 ++++++++++++++++++--- docs/ru/updates.md | 2 +- 6 files changed, 41 insertions(+), 10 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index f5e652f..4c114d9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -84,7 +84,8 @@ branch names, credentials, signing material, or other secrets. fdroidrepo/fdroidrepos links use its API; other named installers use GitHub. Unknown installers or failed capability lookup require a source choice. Preserve the installed APK variant and existing version-code offsets. Downloads require explicit consent; ignored notifications repeat after a week, with skip-version and disable-checks actions. -- The app is not yet available in F-Droid; do not document it as an installation source. +- The app is available in F-Droid: https://f-droid.org/packages/net.megaproxy487/. Keep installation + instructions for F-Droid and GitHub APKs in both English and Russian. - After creating and verifying a release, update the corresponding F-Droid submission/build recipe when required. The repository's F-Droid-related files are for reproducible verification, not an excuse to maintain a duplicate unused build path. diff --git a/README.md b/README.md index 11cba14..4ee0d16 100644 --- a/README.md +++ b/README.md @@ -142,10 +142,10 @@ vendors may impose additional background-execution restrictions. ## Installation -MegaProxy requires Android 8.0 (API 26) or newer. Download a signed APK from +MegaProxy requires Android 8.0 (API 26) or newer. Install it through +[F-Droid](https://f-droid.org/packages/net.megaproxy487/) or download a signed APK from [GitHub Releases](https://github.com/andre487/AndroidMegaProxy/releases/latest). For most users, choose **[mega-proxy-universal.apk](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)**. -The app is not yet available in F-Droid. Detailed instructions cover choosing an APK, installation permissions, checksums, ADB, updates without losing settings, and troubleshooting: diff --git a/docs/en/installation.md b/docs/en/installation.md index ad1be6d..a29680a 100644 --- a/docs/en/installation.md +++ b/docs/en/installation.md @@ -1,4 +1,4 @@ -# Installing MegaProxy from an APK +# Installing MegaProxy [Русская инструкция](../ru/installation.md) @@ -7,6 +7,21 @@ You need a phone or tablet running Android 8.0 or newer. No computer, commands, or GitHub account are needed. An APK is an Android app installation file. +### Through F-Droid + +1. Install the [F-Droid client](https://f-droid.org/) on your phone if you do not have it yet. +2. Open F-Droid, wait for its catalog to refresh, and search for **MegaProxy** + (`net.megaproxy487`). [App listing](https://f-droid.org/packages/net.megaproxy487/). +3. Tap **Install**. If Android asks for permission to install apps from F-Droid, + grant it and confirm installation. +4. Open MegaProxy, add or import your server settings, and tap **Connect**. + Confirm Android's VPN connection request. + +You can install updates through F-Droid. MegaProxy does not provide servers or passwords: +ask the person who set up your server for its settings. + +### From a GitHub APK + **[Download the latest MegaProxy for Android](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)** This permanent link points to the latest universal APK and stays the same when a new version is released. @@ -36,7 +51,7 @@ including updates downloaded within MegaProxy. Menu names may vary. [Samsung instructions](https://www.samsung.com/us/support/answer/ANS10003636/). Button names vary between phones. If a work device's administrator blocks installation, contact -that administrator. The app is not yet available in F-Droid. +that administrator. **Updating:** download the new version using the same link, open the file, and confirm the update. Do not uninstall first; this preserves profiles and settings. If you previously installed an diff --git a/docs/en/updates.md b/docs/en/updates.md index 643bed9..ed0e654 100644 --- a/docs/en/updates.md +++ b/docs/en/updates.md @@ -71,7 +71,7 @@ MegaProxy queries the official per-app API and compares its **suggested**, publi with the installed APK. It does not choose a higher experimental version just because one exists. Installation is handled by F-Droid, including package selection and verification. -MegaProxy is not yet published in F-Droid. A missing listing is displayed as unavailable, not as +A missing listing is displayed as unavailable, not as an up-to-date result. Network/API failures never silently switch the source to GitHub. ## GitHub diff --git a/docs/ru/installation.md b/docs/ru/installation.md index 9d5a4fc..11421c6 100644 --- a/docs/ru/installation.md +++ b/docs/ru/installation.md @@ -1,4 +1,4 @@ -# Установка MegaProxy из APK +# Установка MegaProxy [English installation instructions](../en/installation.md) @@ -7,6 +7,21 @@ Понадобится телефон или планшет с Android 8.0 или новее. Компьютер, команды и аккаунт GitHub не нужны. APK — это установочный файл приложения для Android. +### Через F-Droid + +1. Установите [клиент F-Droid](https://f-droid.org/) на телефон, если его ещё нет. +2. Откройте F-Droid, дождитесь обновления каталога и найдите **MegaProxy** + (`net.megaproxy487`). [Карточка приложения](https://f-droid.org/packages/net.megaproxy487/). +3. Нажмите **Установить**. Если Android запросит разрешение на установку приложений + из F-Droid, выдайте его и подтвердите установку. +4. Откройте MegaProxy, добавьте или импортируйте настройки своего сервера и нажмите + **Подключить**. Подтвердите системный запрос на создание VPN-подключения. + +Обновления можно устанавливать через F-Droid. MegaProxy не предоставляет серверы и пароли: +получите настройки у человека, который настроил ваш сервер. + +### Из APK с GitHub + **[Скачать последнюю версию MegaProxy для Android](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)** Это постоянная ссылка на последний универсальный APK: она остаётся той же при выходе новых версий. @@ -38,7 +53,7 @@ [Инструкция Samsung](https://www.samsung.com/us/support/answer/ANS10003636/). Названия кнопок могут отличаться в зависимости от телефона. Если установку запрещает администратор -рабочего устройства, обратитесь к нему. Приложение пока не добавлено в F-Droid. +рабочего устройства, обратитесь к нему. **Обновление:** скачайте новую версию по той же ссылке, откройте файл и подтвердите обновление. Не удаляйте приложение перед этим — так сохранятся профили и настройки. Если раньше вы ставили @@ -56,7 +71,7 @@ Откройте [последний релиз](https://github.com/andre487/AndroidMegaProxy/releases/latest), разверните список **Assets** и скачайте файл с окончанием `universal.apk`. Это основной рекомендуемый вариант: он поддерживает все перечисленные ниже -архитектуры. Приложение пока не добавлено в F-Droid. Для скачивания релизных APK аккаунт GitHub +архитектуры. Для скачивания релизных APK аккаунт GitHub не нужен. При обновлении по возможности сохраняйте выбранный вариант APK. | APK | Для каких устройств | diff --git a/docs/ru/updates.md b/docs/ru/updates.md index 51cc0cd..613ed2c 100644 --- a/docs/ru/updates.md +++ b/docs/ru/updates.md @@ -73,7 +73,7 @@ MegaProxy обращается к официальному API приложен версии с установленным APK. Более высокая экспериментальная версия не выбирается только из-за большего кода. Установкой, выбором пакета и его проверкой занимается F-Droid. -Приложение пока не опубликовано в F-Droid. Отсутствие карточки показывается как недоступность, +Отсутствие карточки показывается как недоступность, а не как отсутствие обновлений. При ошибке сети или API источник не переключается на GitHub. ## GitHub From 231cc560614b3b79f8227df39535daa5ce52ce5f Mon Sep 17 00:00:00 2001 From: Andrey Prokopyuk Date: Thu, 15 Oct 2026 13:28:41 +0300 Subject: [PATCH 2/2] docs: put GitHub installation before F-Droid --- README.md | 6 +++--- docs/en/installation.md | 26 +++++++++++++------------- docs/ru/installation.md | 26 +++++++++++++------------- 3 files changed, 29 insertions(+), 29 deletions(-) diff --git a/README.md b/README.md index 4ee0d16..cf2e7c2 100644 --- a/README.md +++ b/README.md @@ -142,9 +142,9 @@ vendors may impose additional background-execution restrictions. ## Installation -MegaProxy requires Android 8.0 (API 26) or newer. Install it through -[F-Droid](https://f-droid.org/packages/net.megaproxy487/) or download a signed APK from -[GitHub Releases](https://github.com/andre487/AndroidMegaProxy/releases/latest). +MegaProxy requires Android 8.0 (API 26) or newer. Download a signed APK from +[GitHub Releases](https://github.com/andre487/AndroidMegaProxy/releases/latest) or install it through +[F-Droid](https://f-droid.org/packages/net.megaproxy487/). For most users, choose **[mega-proxy-universal.apk](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)**. Detailed instructions cover choosing an APK, installation permissions, checksums, ADB, diff --git a/docs/en/installation.md b/docs/en/installation.md index a29680a..8c6978f 100644 --- a/docs/en/installation.md +++ b/docs/en/installation.md @@ -7,19 +7,6 @@ You need a phone or tablet running Android 8.0 or newer. No computer, commands, or GitHub account are needed. An APK is an Android app installation file. -### Through F-Droid - -1. Install the [F-Droid client](https://f-droid.org/) on your phone if you do not have it yet. -2. Open F-Droid, wait for its catalog to refresh, and search for **MegaProxy** - (`net.megaproxy487`). [App listing](https://f-droid.org/packages/net.megaproxy487/). -3. Tap **Install**. If Android asks for permission to install apps from F-Droid, - grant it and confirm installation. -4. Open MegaProxy, add or import your server settings, and tap **Connect**. - Confirm Android's VPN connection request. - -You can install updates through F-Droid. MegaProxy does not provide servers or passwords: -ask the person who set up your server for its settings. - ### From a GitHub APK **[Download the latest MegaProxy for Android](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)** @@ -60,6 +47,19 @@ see the update section below or ask a developer for help. Update checks, notifications, skipped versions, and installation: [App updates](updates.md). +### Through F-Droid + +1. Install the [F-Droid client](https://f-droid.org/) on your phone if you do not have it yet. +2. Open F-Droid, wait for its catalog to refresh, and search for **MegaProxy** + (`net.megaproxy487`). [App listing](https://f-droid.org/packages/net.megaproxy487/). +3. Tap **Install**. If Android asks for permission to install apps from F-Droid, + grant it and confirm installation. +4. Open MegaProxy, add or import your server settings, and tap **Connect**. + Confirm Android's VPN connection request. + +You can install updates through F-Droid. MegaProxy does not provide servers or passwords: +ask the person who set up your server for its settings. + ## For developers: APK variants, verification, and troubleshooting The section above is sufficient for a normal installation. The following technical information diff --git a/docs/ru/installation.md b/docs/ru/installation.md index 11421c6..4bef029 100644 --- a/docs/ru/installation.md +++ b/docs/ru/installation.md @@ -7,19 +7,6 @@ Понадобится телефон или планшет с Android 8.0 или новее. Компьютер, команды и аккаунт GitHub не нужны. APK — это установочный файл приложения для Android. -### Через F-Droid - -1. Установите [клиент F-Droid](https://f-droid.org/) на телефон, если его ещё нет. -2. Откройте F-Droid, дождитесь обновления каталога и найдите **MegaProxy** - (`net.megaproxy487`). [Карточка приложения](https://f-droid.org/packages/net.megaproxy487/). -3. Нажмите **Установить**. Если Android запросит разрешение на установку приложений - из F-Droid, выдайте его и подтвердите установку. -4. Откройте MegaProxy, добавьте или импортируйте настройки своего сервера и нажмите - **Подключить**. Подтвердите системный запрос на создание VPN-подключения. - -Обновления можно устанавливать через F-Droid. MegaProxy не предоставляет серверы и пароли: -получите настройки у человека, который настроил ваш сервер. - ### Из APK с GitHub **[Скачать последнюю версию MegaProxy для Android](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)** @@ -62,6 +49,19 @@ Проверки, уведомления, пропуск версий и установка: [Обновления приложения](updates.md). +### Через F-Droid + +1. Установите [клиент F-Droid](https://f-droid.org/) на телефон, если его ещё нет. +2. Откройте F-Droid, дождитесь обновления каталога и найдите **MegaProxy** + (`net.megaproxy487`). [Карточка приложения](https://f-droid.org/packages/net.megaproxy487/). +3. Нажмите **Установить**. Если Android запросит разрешение на установку приложений + из F-Droid, выдайте его и подтвердите установку. +4. Откройте MegaProxy, добавьте или импортируйте настройки своего сервера и нажмите + **Подключить**. Подтвердите системный запрос на создание VPN-подключения. + +Обновления можно устанавливать через F-Droid. MegaProxy не предоставляет серверы и пароли: +получите настройки у человека, который настроил ваш сервер. + ## Для разработчиков: варианты APK, проверка и диагностика Для обычной установки достаточно раздела выше. Далее приведены технические сведения