Skip to content
Open
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
158 changes: 158 additions & 0 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
name: Build and Release

on:
push:
tags:
- 'v*'
workflow_dispatch:

permissions:
contents: write
packages: write

jobs:
build-windows:
runs-on: windows-latest

steps:
- name: Checkout code
uses: actions/checkout@v4

- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: '3.11'

- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install -r requirements.txt

- name: Build EXE with PyInstaller
run: |
pyinstaller --onefile --name "ABBB" --icon=abbb.ico --add-data "README.md;." abbb_v2.py
continue-on-error: true

- name: Build EXE without icon (fallback)
if: failure()
run: |
pyinstaller --onefile --name "ABBB" --add-data "README.md;." abbb_v2.py

- name: Upload artifact
uses: actions/upload-artifact@v4
with:
name: ABBB-Windows
path: dist/ABBB.exe

- name: Create Release
uses: softprops/action-gh-release@v1
with:
files: dist/ABBB.exe
body: |
## AternosBringBackBackups v${{ github.ref_name }}

### Что нового:
- Прямое подключение к Aternos через веб-API
- Скачивание всех файлов сервера (миры, плагины, конфиги)
- Интерактивный режим выбора сервера и типа скачивания
- Сохранение учётных данных для быстрого входа

### Как использовать:
1. Запустите ABBB.exe
2. Введите логин и пароль от аккаунта Aternos
3. Выберите сервер
4. Выберите что скачать (всё/миры/плагины)
5. Файлы будут сохранены на рабочем столе в папке AternosBackups

### Требования:
- Действующий аккаунт Aternos
- Интернет-соединение
draft: false
prerelease: false
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

build-linux:
runs-on: ubuntu-latest

steps:
- name: Checkout code
uses: actions/checkout@v4

- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: '3.11'

- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install -r requirements.txt

- name: Build executable with PyInstaller
run: |
pyinstaller --onefile --name "ABBB" --add-data "README.md:." abbb_v2.py
continue-on-error: true

- name: Upload artifact
uses: actions/upload-artifact@v4
with:
name: ABBB-Linux
path: dist/ABBB

- name: Add to Release
uses: softprops/action-gh-release@v1
with:
files: dist/ABBB
body: |
## AternosBringBackBackups v${{ github.ref_name }}

### Linux версия
Сделайте файл исполняемым: `chmod +x ABBB`
Запуск: `./ABBB`
draft: false
prerelease: false
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

build-macos:
runs-on: macos-latest

steps:
- name: Checkout code
uses: actions/checkout@v4

- name: Set up Python
uses: actions/setup-python@v5
with:
python-version: '3.11'

- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install -r requirements.txt

- name: Build executable with PyInstaller
run: |
pyinstaller --onefile --name "ABBB" --add-data "README.md:." abbb_v2.py
continue-on-error: true

- name: Upload artifact
uses: actions/upload-artifact@v4
with:
name: ABBB-macOS
path: dist/ABBB

- name: Add to Release
uses: softprops/action-gh-release@v1
with:
files: dist/ABBB
body: |
## AternosBringBackBackups v${{ github.ref_name }}

### macOS версия
Запуск: `./ABBB` или дважды кликните в Finder
draft: false
prerelease: false
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
27 changes: 27 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
```gitignore
# Python
__pycache__/
*.pyc
*.pyo
*.pyd

# Dependencies
venv/
.venv/
.env
.env.local
*.env.*

# Logs and temp files
*.log
*.tmp

# Editors
.vscode/
.idea/

# Build artifacts
dist/
build/
*.spec
```
85 changes: 70 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,31 +11,86 @@

This utility is built on an optimized script designed to download backups (by default) to your desktop from your Aternos servers; if you are planning to switch hosting providers for your server, this utility is the perfect solution!

## 🆕 Версия 2.0 - Прямое подключение к Aternos!

Новая версия программы теперь использует **прямое подключение к API Aternos**, что делает её более надёжной и функциональной:

- ✅ **Прямая авторизация** через логин/пароль Aternos
- ✅ **Скачивание всех файлов сервера**: миры, плагины, конфиги, логи
- ✅ **Интерактивный выбор** сервера и типа данных для скачивания
- ✅ **Сохранение учётных данных** для быстрого входа
- ✅ **Автоматическая сборка** в .exe через GitHub Actions

<br>![Divider](https://tr7zw.github.io/uikit/divider_faded/Divider_03.png)

<br>![Features](https://tr7zw.github.io/uikit/headlines/large/Features.png)
### For Developers
- Go to the [Google Cloud Console](https://console.cloud.google.com/?spm=a2ty_o01.29997173.0.0.64a155fbvmooUf)
- Create a new project
- Enable the Google Drive API
- Go to APIs & Services > Credentials
- Create an OAuth 2.0 Client ID (type: Desktop app)
- Download the JSON file and save it as `client_secret.json` in the program folder

### For user
- Go in latest release
- Download zip and extract folder
- open exubetle file
- start working

### Быстрый старт

#### Вариант 1: Скачать готовый релиз
1. Перейдите в раздел [Releases](https://github.com/JunDevX/AternosBringBackBackups/releases)
2. Скачайте последнюю версию для вашей ОС
3. Запустите и следуйте инструкциям

#### Вариант 2: Собрать из исходников
```bash
# Установка зависимостей
pip install -r requirements.txt

# Запуск скрипта
python abbb_v2.py

# Или собрать .exe (требуется PyInstaller)
pyinstaller --onefile --name "ABBB" abbb_v2.py
```

<br>![Divider](https://tr7zw.github.io/uikit/divider_faded/Divider_03.png)

<br>![How to Use](https://tr7zw.github.io/uikit/headlines/large/How%20to%20Use.png)

### Пошаговая инструкция

1. **Запустите программу** (ABBB.exe или `python abbb_v2.py`)
2. **Введите учётные данные** от вашего аккаунта Aternos
3. **Выберите сервер** из списка ваших серверов
4. **Выберите тип скачивания**:
- Всё (миры, плагины, конфиги)
- Только миры
- Только плагины
5. **Дождитесь завершения** — файлы будут сохранены на рабочем столе в папке `AternosBackups`

<br>![Divider](https://tr7zw.github.io/uikit/divider_faded/Divider_03.png)

<br>![Known Issues](https://tr7zw.github.io/uikit/headlines/medium/Known%20Issues.png)

If you encounter technical issues, first check the Issues section—a solution has likely already been found there; if that doesn't help, reach out via the Discord channel.
Если вы encounter технические проблемы, сначала проверьте раздел Issues — возможно решение уже найдено; если это не поможет, обратитесь через канал Discord.

<br>![Divider](https://tr7zw.github.io/uikit/divider_faded/Divider_03.png)

<br>![FAQ](https://tr7zw.github.io/uikit/headlines/medium/FAQ.png)

not now
### Часто задаваемые вопросы

**Q: Безопасно ли вводить пароль от Aternos?**
A: Да, программа отправляет данные напрямую на серверы Aternos через защищённое HTTPS-соединение. Пароль нигде не сохраняется (если вы сами не включите опцию сохранения).

**Q: Почему не работает старая версия через Google Drive?**
A: Aternos изменил способ создания резервных копий. Новая версия использует прямое API, что надёжнее.

**Q: Можно ли скачать конкретный файл?**
A: В текущей версии можно выбрать тип данных (миры/плагины/всё). Индивидуальный выбор файлов планируется в будущих версиях.

**Q: Программа не запускается на Windows**
A: Убедитесь, что у вас установлены Visual C++ Redistributable. Также попробуйте запустить от имени администратора.

<br>![Divider](https://tr7zw.github.io/uikit/divider_faded/Divider_03.png)

<br>![Build Status](https://tr7zw.github.io/uikit/headlines/medium/Build%20Status.png)

[![Build and Release](https://github.com/JunDevX/AternosBringBackBackups/actions/workflows/build.yml/badge.svg)](https://github.com/JunDevX/AternosBringBackBackups/actions/workflows/build.yml)

<br>![Divider](https://tr7zw.github.io/uikit/divider_faded/Divider_03.png)

**Лицензия:** MIT
**Автор:** JunDevX
**Поддержка:** [Discord](https://dsc.gg/minecraftheal)
15 changes: 15 additions & 0 deletions abbb.spec.cfg
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
[Build]
app_name=ABBB
app_version=2.0.0
app_author=JunDevX

[Output]
onefile=True
console=True
icon=abbb.ico

[Data]
readme=README.md

[Hook]
hidden_imports=requests,bs4,urllib3
Loading