WP-Downloader Android
Make everything so simple.
This will guide you to use WP Downloader in an Android device on localhost.
For iOS, you may try to configure iSH, the Termux equivalent. Most of the configuration would be the same.
Note that this documentation is absolutely NOT For Seniors. It's for noobs.
Get Started
-
What we will do?
We'll use Termux, a Linux Terminal Emulator, to install NodeJS, and run WP-Downloader.
We are going to do the same thing we used to do in Desktop, but now in Android (thanks to the Electron Wrapper).
For additional information, visit the wp-downloader source repo.
For beginners: In Termux, to execute commands, you need to slide the command bar at the bottom (with buttons like `ESC`, `CTRL`, `ALT`, etc.) to the right to get a text input. Type the command and press `Enter` to display it in the CLI. Press `Enter` again to execute it.
🟢 Steps to Install, Configure & Run for FIRST TIME
When running commands in the Termux terminal, you should NOT click on the terminal itself, as it will pause the process. If you pause it, you need to press the `Enter` key to resume.
Use the `Copy` button in the code blocks to avoid errors from typos.
-
Install Termux
First, install Termux. You can download it from F-Droid, GitHub Releases, or the Play Store. Install it like any other app.
-
Open Termux
Make sure you have an active internet connection. Open Termux. It will ask for Notification Permissions (we recommend you allow them) and then install `Bootstrap Packages` automatically.
-
PKG Update
After `Bootstrap Packages` are installed, execute the following command to check for updates.
pkg update -y -
PKG Upgrade
Next, upgrade already installed packages to their latest versions.
pkg upgrade -yIf you're prompted for `Yes/No`, type `y` and press Enter.
-
Install Git
We need `git` to clone the `WP-Downloader` repository.
pkg install -y git -
Install NodeJS
We need `NodeJS` to run `WP-Downloader`.
pkg install -y nodejs -
Clone Repository
Now, clone the `WP-Downloader` repository.
git clone https://github.com/MaximilianGT500/wp-downloader.gitYou must add
.gitat the end of the URL to clone without logging into GitHub. -
Change Directory
Navigate into the cloned `wp-downloader` folder.
cd wp-downloader -
Install node-modules
Install the third-party dependencies.
npm install -
Install PM2
Install `pm2` globally to run `wp-downloader` in the background.
npm install pm2 -g -
Run WP-Downloader
Start `WP-Downloader` with `pm2`. This will deploy it to localhost and name the process `wpdl`.
pm2 start npm --name wpdl -- run startNote that there is a space between
--andrun. It's-- run. However,--namehas no space. -
Save PM2 Configuration
Saving the PM2 configuration allows you to restart the app easily later.
pm2 saveSaving the PM2 config is not essential but is recommended for convenience.
-
Use WP-Downloader
The app is now deployed. Open any web browser on your device and go to the following address:
localhost:3000
Here's a short demonstration on how to install, configure and run for the first time:
Download Video Demonstration 📥🟢 Run WP-Downloader - IF YOU SAVED PM2 CONFIG
If you have already configured `WP-Downloader` and saved the PM2 config but the app is not running, follow these steps.
-
Open Termux
Just open the Termux app.
-
Run WP-Downloader
Because you saved the PM2 config, you can start the app from any directory with this short command.
pm2 start wpdl -
Use WP-Downloader
Access the app in your browser at:
localhost:3000
🟢 Run WP-Downloader - IF YOU DID NOT SAVE PM2 CONFIG
If you did not save the PM2 configuration during the initial setup, follow these steps to start the app again.
-
Open Termux
Open the Termux app.
-
Change Directory
You must navigate to the `wp-downloader` directory first.
cd wp-downloader -
Run WP-Downloader
Start the app using the original long command.
pm2 start npm --name wpdl -- run start -
Use WP-Downloader
Access the app in your browser at:
localhost:3000
🟢 Stop & Restart WP-Downloader
-
Stop WP-Downloader
To stop the running application, use the following command. You do not need to be in the `wp-downloader` directory.
pm2 stop wpdl -
Restart WP-Downloader
If you want to restart the application, use this command. Again, you can run this from anywhere.
pm2 restart wpdl