Merge pull request #16 from Alvin-Zilverstand/main

feat: Add Linux executable and compilation instructions
This commit is contained in:
afkarxyz authored and GitHub committed 2025-07-12 22:12:19 +07:00
commit c7615ed2f6
3 files changed
+70 -1

No files matched your search

+4
View File
@@ -0,0 +1,4 @@
dist/
build/
*.spec
.venv/
+60 -1
View File
@@ -8,7 +8,8 @@
## 📥 Download
- Download the latest version of [TwitterXMediaBatchDownloader](https://github.com/afkarxyz/Twitter-X-Media-Batch-Downloader/releases/download/v3.0/TwitterXMediaBatchDownloader.exe)
- **Windows**: Download the latest version of [TwitterXMediaBatchDownloader](https://github.com/afkarxyz/Twitter-X-Media-Batch-Downloader/releases/download/v3.0/TwitterXMediaBatchDownloader.exe)
- **Linux**: Download the latest version of [TwitterXMediaBatchDownloader](https://github.com/afkarxyz/Twitter-X-Media-Batch-Downloader/releases/download/v3.0/TwitterXMediaBatchDownloader)
- If you're familiar with **userscripts**, please install it [here](https://greasyfork.org/en/scripts/523157)
## ✨ Features
@@ -27,6 +28,64 @@
![image](https://github.com/user-attachments/assets/9ccc945c-7318-4232-8ba3-9fbb636fa065)
## 🛠️ Compiling from Source (Ubuntu/Linux)
Follow these steps to compile and run the application from source:
### 1. Install Required Packages
```bash
sudo apt install git python3-pip python3-venv
```
### 2. Clone the Repository
```bash
git clone https://github.com/afkarxyz/Twitter-X-Media-Batch-Downloader.git
cd Twitter-X-Media-Batch-Downloader
```
### 3. Create and Activate a Virtual Environment
```bash
python3 -m venv .venv
source .venv/bin/activate
```
### 4. Install Python Dependencies
```bash
pip install -r requirements.txt
pip install pyinstaller
```
### 5. Build the Executable
```bash
pyinstaller --onefile --windowed TwitterXMediaBatchDownloader.py
```
### 6. Run the Application
The compiled binary will be located in the `dist/` folder:
```bash
./dist/TwitterXMediaBatchDownloader
```
### ❓ The downloaded file won't run?
If the binary file you downloaded doesn’t run (e.g., double-clicking does nothing or you get a “permission denied” error), it’s likely missing the executable permission.
✅ **Solution**: Open your terminal and run:
```bash
chmod +x TwitterXMediaBatchDownloader
./TwitterXMediaBatchDownloader
```
This will give the file permission to run on your system.
## 🔑 How to Obtain Auth Token
> [!Warning]
+6
View File
@@ -0,0 +1,6 @@
PyQt6
requests
aiohttp
imageio-ffmpeg
packaging
gallery-dl