Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,9 +143,9 @@ vendors may impose additional background-execution restrictions.
## Installation

MegaProxy requires Android 8.0 (API 26) or newer. Download a signed APK from
[GitHub Releases](https://github.com/andre487/AndroidMegaProxy/releases/latest).
[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)**.
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:
Expand Down
19 changes: 17 additions & 2 deletions docs/en/installation.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Installing MegaProxy from an APK
# Installing MegaProxy

[Русская инструкция](../ru/installation.md)

Expand All @@ -7,6 +7,8 @@
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.

### 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.
Expand Down Expand Up @@ -36,7 +38,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
Expand All @@ -45,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
Expand Down
2 changes: 1 addition & 1 deletion docs/en/updates.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
21 changes: 18 additions & 3 deletions docs/ru/installation.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Установка MegaProxy из APK
# Установка MegaProxy

[English installation instructions](../en/installation.md)

Expand All @@ -7,6 +7,8 @@
Понадобится телефон или планшет с Android 8.0 или новее. Компьютер, команды и аккаунт GitHub
не нужны. APK — это установочный файл приложения для Android.

### Из APK с GitHub

**[Скачать последнюю версию MegaProxy для Android](https://github.com/andre487/AndroidMegaProxy/releases/latest/download/mega-proxy-universal.apk)**

Это постоянная ссылка на последний универсальный APK: она остаётся той же при выходе новых версий.
Expand Down Expand Up @@ -38,7 +40,7 @@
[Инструкция Samsung](https://www.samsung.com/us/support/answer/ANS10003636/).

Названия кнопок могут отличаться в зависимости от телефона. Если установку запрещает администратор
рабочего устройства, обратитесь к нему. Приложение пока не добавлено в F-Droid.
рабочего устройства, обратитесь к нему.

**Обновление:** скачайте новую версию по той же ссылке, откройте файл и подтвердите обновление.
Не удаляйте приложение перед этим — так сохранятся профили и настройки. Если раньше вы ставили
Expand All @@ -47,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, проверка и диагностика

Для обычной установки достаточно раздела выше. Далее приведены технические сведения
Expand All @@ -56,7 +71,7 @@

Откройте [последний релиз](https://github.com/andre487/AndroidMegaProxy/releases/latest), разверните список **Assets** и скачайте файл с окончанием
`universal.apk`. Это основной рекомендуемый вариант: он поддерживает все перечисленные ниже
архитектуры. Приложение пока не добавлено в F-Droid. Для скачивания релизных APK аккаунт GitHub
архитектуры. Для скачивания релизных APK аккаунт GitHub
не нужен. При обновлении по возможности сохраняйте выбранный вариант APK.

| APK | Для каких устройств |
Expand Down
2 changes: 1 addition & 1 deletion docs/ru/updates.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ MegaProxy обращается к официальному API приложен
версии с установленным APK. Более высокая экспериментальная версия не выбирается только из-за
большего кода. Установкой, выбором пакета и его проверкой занимается F-Droid.

Приложение пока не опубликовано в F-Droid. Отсутствие карточки показывается как недоступность,
Отсутствие карточки показывается как недоступность,
а не как отсутствие обновлений. При ошибке сети или API источник не переключается на GitHub.

## GitHub
Expand Down
Loading