Barag_DL

Baraag DL

Pengunduh media Baraag sederhana, dibuat sebagai cara sederhana untuk mengunduh semua gambar/video dalam postingan yang dibuat oleh akun yang Anda ikuti.

Terinspirasi oleh PixivUtil dan FantiaDL.

Terima kasih banyak kepada orang-orang di Mastodon.py karena telah membuat penerapan ini lebih mudah dari yang diharapkan.

Instalasi

Linux/MacOS

Direkomendasikan

• Buat lingkungan dengan: python3 -m venv baraag_dl

• Aktifkan lingkungan: source baraag_dl/bin/activate

• Unduh persyaratan.txt dan baraag_dl.py ke folder Anda saat ini.

• Instal dependensi: python3 -m pip install -r requirements.txt

• Alternatifnya, instal paket berikut menggunakan python3 -m pip install :

 colorama
Mastodon.py
requests

• Jalankan Baraag_DL: python3 baraag_dl.py

• Setelah selesai berjalan, tutup terminal atau nonaktifkan lingkungan dengan: deactivate

Pengaturan tambahan opsional

• Untuk menambah kenyamanan, saya sarankan membuat skrip shell untuk mengeksekusi baraag_dl.py menggunakan juru bahasa Python dari lingkungan yang Anda buat di atas, atau memodifikasi baraag_dl.py untuk menunjuk ke juru bahasa Python lingkungan saat mengeksekusi.

• Untuk yang pertama, jika kami menganggap Anda membuat lingkungan baraag_dl di folder utama Anda, buatlah file yang berisi baris berikut di folder yang sama dengan baraag_dl.py :

 #!/bin/bash

~/baraag_dl/bin/python3 baraag_dl.py

• Simpan file dengan nama pilihan Anda (sebut saja run.sh untuk contoh ini), dan berikan izin eksekusi dengan chmod +x run.sh .

• Mulai saat ini, Anda seharusnya dapat menjalankan Baraag DL dengan menjalankan run.sh , tanpa perlu mengaktifkan atau menonaktifkan lingkungan.

• Untuk yang terakhir, ubah baris pertama di baraag_dl.py menjadi #!~/baraag_dl/bin/python3

• Mulai saat ini, Anda seharusnya dapat menjalankan baraag_dl.py secara langsung, tanpa perlu mengaktifkan atau menonaktifkan suatu lingkungan.

• Perlu diketahui bahwa jika Anda memilih yang terakhir, Anda perlu mengulangi modifikasi ini setiap kali Anda memperbarui Baraag DL.

Alternatif 1

• Lewati lingkungan virtual dan instal persyaratan ke instalasi dasar Python menggunakan pip install untuk menginstal paket yang diperlukan yang tercantum di atas.

Alternatif 2

• Gunakan Anaconda/miniconda/miniforge untuk membuat lingkungan, menginstal paket yang diperlukan, dan menjalankan baraag_dl.py dari dalam lingkungan.

jendela

Direkomendasikan

• Unduh binari yang sudah dikemas sebelumnya.

Alternatif

• Unduh dan instal Python jika belum diinstal.

• Buat lingkungan dengan: py -m venv baraag_dl

• Aktifkan lingkungan: baraag_dlScriptsactivate

• Unduh persyaratan.txt dan baraag_dl.py ke folder Anda saat ini.

• Instal dependensi: py -m pip install -r requirements.txt

• Alternatifnya, instal paket berikut menggunakan py -m pip install :

 colorama
Mastodon.py
requests

• Jalankan Baraag_DL: py baraag_dl.py

• Setelah selesai berjalan, tutup terminal atau nonaktifkan lingkungan dengan: deactivate

Penggunaan

Masuk dan otentikasi

Jalankan pertama

• Baraag DL akan mendaftarkan klien dengan API Mastodon yang digunakan oleh Baraag.
• Ini akan menghasilkan token autentikasi persisten, client_credentials di folder yang sama tempat baraag_dl.py dijalankan.
• Anda akan dimintai nama pengguna (email) dan kata sandi untuk masuk ke akun Baraag Anda.
• Jika login berhasil, Baraag DL akan menghasilkan token pengguna persisten, user_credentials di folder yang sama tempat baraag_dl.py dijalankan.

Berjalan selanjutnya

• Jika client_credentials dan user_credentials masih valid, autentikasi akan terjadi tanpa masukan pengguna.
• Jika salah satu atau kedua file menjadi tidak valid atau rusak, Baraag DL akan membuat ulang klien dan meminta Anda memasukkan nama pengguna dan kata sandi lagi.

Eksekusi

• Anda kemudian akan diperlihatkan menu dan ditanya bagaimana Anda ingin melanjutkan:

1. Unduh dari semua akun yang diikuti

• Baraag DL secara otomatis akan:
  • Ambil semua akun yang Anda ikuti
  • Ambil semua postingan dari akun yang Anda ikuti yang berisi lampiran
  • Unduh setiap lampiran secara berurutan untuk semua akun yang diikuti

2. Cari pengguna tertentu

• Baraag DL kemudian akan meminta Anda memasukkan nama artis/akun yang akan dicari.
• Jika pencarian berhasil, Anda akan diberi daftar akun yang cocok dengan nama yang Anda masukkan.
• Anda kemudian dapat memilih di antara opsi daftar akun tempat semua media akan diunduh.

Pengunduhan dan Nama File

• File disimpan sebagai {Date posted}_{Post ID}_{Attachment_ID}.extension dalam folder untuk setiap akun, diberi nama dalam format {Account name}_{Account ID} . Perlu diingat bahwa Account name tidak sama dengan Display name , sehingga nama publik akun dan nama pendaftaran Baraag mungkin berbeda.
• File yang sudah diunduh dan disimpan ke disk dilewati untuk menghemat waktu, bandwidth, dan tidak membombardir API dengan permintaan.

️ API Mastodon dibatasi hingga 300 permintaan setiap 5 menit. Ini berarti Baraag DL akan berjalan jauh lebih lambat setelah beberapa waktu untuk mencegah terputusnya API.

Agenda

• Menerapkan mode uji coba (debugging)
• Menerapkan kompatibilitas Pawoo.
• Instal skrip untuk MacOS/Linux (?)