diff --git a/README.md b/README.md index aa035cb44..0449283f5 100644 --- a/README.md +++ b/README.md @@ -1,99 +1,152 @@ + + + + # VTosters Lite -ВТостерс Lite - это модифицированный клиент (декомпиляция) официального ВКонтакте основанный на версии 5.56.1 (4838) +**ВТостерс Lite** - это модифицированный клиент официального ВКонтакте, основанный на версии **5.56.1 (4838)** -О найденных багах сообщать в [issues](https://github.com/vtosters/lite/issues), просьба не плодить дубликаты, воспользуйтесь поиском перед созданием нового issue +* О найденных багах приложения следует сообщать в [Issues](https://github.com/vtosters/lite/issues) +(просьба не плодить дубликаты, воспользуйтесь **поиском** перед созданием нового issue) -Скачивать самые актуальные версии можно с [Actions](https://github.com/vtosters/lite/actions) +* Скачивать самые актуальные версии можно с [Actions](https://github.com/vtosters/lite/actions) +(могут содержать баги) -Стабильные сборки находятся в [Releases](https://github.com/vtosters/lite/releases) +* Стабильные сборки находятся в [Releases](https://github.com/vtosters/lite/releases) -Зеркало на нашем [Git](https://git.maki.su/gdlbo/lite) +Зеркало на нашем [ Git](https://git.maki.su/gdlbo/lite) -Зеркало на [Github](https://github.com/vtosters/lite) +## Функционал + +* Лента + * Блокировка рекламы в ленте + * Блокировка постов через фильтры + * Возможность отключить рекомендации от ВК +* Редактор докбара +* Редактор элементов Superpp +* Медиа контент + * Округление дат + * 1 января в 4:20 + * 1 января в 4:20:00 + * 1 января 2000 в 4:20:00 + * Округление чисел + * Сокращение постов **(Показать полностью)** + * Результаты опросов без участия + * Интеграция с LAST.FM (а также возможность скробблинга) + * Новый раздел музыки + * Возможность скачивать видео + * Возможность найти фотографию через поисковые системы + * Интеграция с VK X +* Сообщения + * Обои в сообщениях + * Возможность выключения кнопки записи голосовых сообщений + * Возможность скрыть блок рекомендаций в сообщениях + * Режим **VK Me** + * Возможность вернуть вкладку уведомлений + * Альтернативный дизайн эмодзи меню + * Возможность использовать системные эмодзи +* Активность + * Возможность видеть удаленные сообщения + * Функционал, позволяющий оставаться в "оффлайне" (принудительный оффлайн/не отправлять статус онлайна и т.п.) + * Нечиталка/неписалка для ЛС/бесед/ботов/групп + * Возможность отключить информацию о том, что вы просмотрели историю/прослушали голосовое сообщение + * Возможность видеть онлайн пользователей, если у вас скрыт онлайн через VK Messenger + * Отключить уведомление о том, что вы сделали скриншот в беседе + * Отключение редиректа через away.php +* Внешний вид + * **Milkshake** тема (дизайн новых версий ВК) + * Название заголовков в докбаре + * Возможность использовать акцент для иконок + * Возможность отключить счётчики в докбаре + * Смена иконки приложения (содержит много уникальных иконок для донатеров) + * Возможность покрасить панель навигации, веб-страницы +* Telegram Стикеры + * Возможность загружать свои стикерпаки из Telegram во ВКонтакте +* Интерфейс + * Возможность отключить блок историй наверху ленты + * Возможность отключить боковую камеру в разделе "Новости" + * Возможность отключить блок "Что у вас нового?" в разделе "Новости" + * Возможность менять раздел, который запускается при запуске + * Анимации фрагментов + * Возможность отключить редизайн видеопостов + * Возможность отключить блок миниаппов/VK Pay/Superapp + * Возможность отключить сокращение названий разделов в меню + * Возможность скрыть блок рекомендаций друзей в разделе "Друзья" + * Возможность скрыть подписи в настройках +* Прокси + * Возможность использовать **HTTP/HTTPS/SOCKS** прокси, менять домены **API/OAuth/Static** +* Другое + * Очистка кеша приложения (**всё/стикеры/изображения/видео/сообщения/WebView**) + * Автоочистка кеша при достижении указанного вами значения (**100/500 MB, 1/2/5 GB**) + * Функционал для **дебага приложения/бэкап возможности/верификации VTosters** + +А также: +* Галочки, которые видны только пользователям приложения **ВТостерс Lite** (подробнее тут: [vtosters.app](https://vtosters.app) ➝ Пожертвования) +* Оптимизация приложения VK (удаление ненужных библиотек, которые встроены в оригинальный VK) + +И многое другое! ## Отладка приложения -Для отладки с помощью Android Studio необходимо пройти в `/smali/AndroidManifest.xml` -``` -android:debuggable="false" -> android:debuggable="true" -``` +Для отладки с помощью Android Studio необходимо пройти в `/smali/AndroidManifest.xml` и изменить значение `android:debuggable`: -Для дополнительной отладки ответов, доп логов и подмены данных для дебаг приложения необходимо включить **Режим разработчика** -``` -Настройки -> О приложении -> Для разработчиков -> Режим разработчика -``` +`android:debuggable="false"` ➝ `android:debuggable="true"` -Для просмотра трафика необходимо отключить функцию **SSL Pinning** +Настройки, необходимые для **отладки** вне Android Studio, находятся по этой ссылке: [vk.com/vt/debug](https://vk.com/debug) -``` -Настройки -> О приложении -> Для разработчиков -> SSL Pinning -``` +* Для дополнительной отладки ответов и логов необходимо включить **[Режим разработчика]** -Для логгирования внутренних запросов к API необходимо включить функции **Логгирование API** +* Для просмотра SSL-трафика необходимо **отключить** функцию **[SSL Pinning]** -(Работает только при использовании внутреннего логгера!) +* Для логгирования внутренних запросов к API необходимо включить функцию **[Логгирование API]** (работает только при использовании внутреннего логгера!) -``` -Настройки -> О приложении -> Для разработчиков -> Логгирование API -``` +* Для использования внутреннего логгера необходимо включить функцию **[Запись логов в файл]** -Для использования внутреннего логгера необходимо включить функции **Запись логов в файл** -``` -Настройки -> О приложении -> Для разработчиков -> Запись логов в файл -``` -Сразу после нажатия на запись аппа начнет записывать **все действия** в файлы по пути -``` -/VK/logs/com.vtosters.lite -``` -При следующем открытии аппы она автоматически запакует эти файлы и отправит вам в **Документы** ВК +Сразу после нажатия на запись приложение начнет записывать **все ваши действия** по пути `/VK/logs/com.vtosters.lite` -Позже архив можно будет скачать и работать с файлами логов которые находятся в нем +При следующем открытии приложения оно автоматически сохранит логи и отправит вам в [**Документы** ВК](https://vk.com/docs), откуда вы можете скачать архив логов и работать с ними. ## Разработка -Для понимания декомпилированного кода требуется использовать **Dex to Java** декомпилятор [jadx](https://github.com/skylot/jadx) или же сторонние варианты как [Fernflower](https://github.com/fesh0r/fernflower) +Для понимания работы декомпилированного кода требуется использовать **Dex to Java** декомпилятор [jadx](https://github.com/skylot/jadx) или же сторонние варианты как [Fernflower](https://github.com/fesh0r/fernflower) -Рекомендуется установка **Android Debug Bridge** в систему ([Гайд как это сделать](https://technastic.com/system-wide-adb-fastboot-windows-10)) +При нахождении решения каких-либо проблем ждем вас в [Pull Requests](https://github.com/vtosters/lite/pulls) -Для индексации декомпилированного кода в Studio используется [dex2jar](https://github.com/pxb1988/dex2jar) +* Рекомендуется установка **ADB** в систему ([гайд](https://technastic.com/system-wide-adb-fastboot-windows-10)) -Сгенерированные библиотеки из дексов находятся в `/app/libs` +* Для индексации декомпилированного кода в Studio используется [dex2jar](https://github.com/pxb1988/dex2jar) -При чистой перекомпиляции дексов в jar может сломаться некоторая индексация файлов, исправляйте ручками что попадется (К примеру какие-то функции в дексах изменены с **private** на **public**) +Сгенерированные библиотеки из .dex файлов находятся в `/app/libs` + +При чистой перекомпиляции .dex в .jar может сломаться некоторая индексация файлов, исправляйте ручками что попадется (К примеру какие-то функции в дексах изменены с **private** на **public**) Для сборки декомпилированного кода и ресурсов используется [Apktool](https://github.com/iBotPeaches/Apktool) -А при нахождении решения каких-либо проблем ждем вас в [Pull Requests](https://github.com/vtosters/lite/pulls) - ### Всё необходимое для сборки и компиляции -`Не меняйте packagename во избе­жа­ние проблем с приложением` +```diff +- Не меняйте имя пакета во избежание проблем с приложением -`Некоторые функции связанные с музыкой не будут работать в пересобранном приложении` +- Некоторые функции, связанные с музыкой не будут работать в пересобранном приложении +``` -Весь декомпилированный код клиента находится в `/smali` +* Весь декомпилированный код клиента находится в `/smali` -Весь исходный код модификации находится в `/app` +* Весь исходный код модификации находится в `/app` -Все необходимые скрипты/жарники для компиляции APK, его подписывании и не только находятся в `/scripts` +* Все необходимые скрипты/.jar файлы для компиляции APK, его подписывании и не только находятся в `/scripts` ### Необходимые зависимости -Требуется установленная **Java** >11 версии + **JDK** >11 версии -Требуется установленная **Android Studio** + **Android Studio** ### Linux/macOS -``` -./build.sh -``` - -![](https://cdn.discordapp.com/attachments/762063967979175946/961657476317581393/unknown.png) +Для сборки используется файл `./build.sh` + ### Windows -``` -build.bat -``` +Для сборки используется файл `build.bat` -![](https://cdn.discordapp.com/attachments/762063967979175946/961682299366309928/unknown.png) +