Skip to content

An Android app to run Openpyn remotely through JuiceSSH

License

Notifications You must be signed in to change notification settings

1951FDG/openpyn-nordvpn-juiceSSH

Repository files navigation

openpyn-nordvpn-juiceSSH, a JuiceSSH plugin

An Android app written in C/C++, Java, and Kotlin to run Openpyn remotely through JuiceSSH. Special thanks to NvidiaGpuMonitor, a JuiceSSH plugin written in Kotlin by sds100 which served as a base for this JuiceSSH plugin.

Note: The first public beta has been released.

Todo

  • add Telnet functionality for connecting to OpenVPN management interface
  • apply clean(er) app architecture

Table of Contents

Introduction

The idea all started when I wanted to connect to OpenVPN servers hosted by NordVPN on a Asus RT-AC86U. By default this is possible, but the default firmware including third party firmware Asuswrt-merlin only allow for a maximum of 5 OpenVPN Clients to be saved.

I then stumbled on Openpyn, quickly learned Python, and made a pull request, enabling support for Asuswrt-merlin. Openpyn is a python3 script which can be run on Entware-ng-3x on Asuswrt-merlin. The main feature of Openpyn, is that it automatically connects to the least busy, lowest latency OpenVPN server. NVRAM write support for Asuswrt-merlin in Openpyn is then able to save the least busy, lowest latency OpenVPN server to the NVRAM of a Entware-ng-3x enabled ASUS router.

Now, I had achieved more or less what I desired, but this left me with one last struggle, having to resort to open a SSH connection to the ASUS router and supplying Openpyn with the desired arguments e.g., country, load threshold, server type, and number of pings to be sent to each server to determine quality. I thought that having the ability to do that on my phone instead of my computer would make this a lot easier, and that led me to discovering JuiceSSH.

JuiceSSH supports the use of plugins, which allowed me to create this fantastic app. This app runs on Android, it establishes a connection to a device that has a SSH server running on it, and it is then able to send a Openpyn command to the remote device.

Note: This project is my very first Android project, and as such, it may not follow all the best coding practices yet, regardless of this, I'm committed to make this app a source of inspiration for other developers working on similar based Android apps, especially Google Maps based Android apps.

Features

  • Supports most arguments available in Openpyn with easy to use preferences

  • Allows to use location based filtering in Openpyn

  • Map view displays markers for every country supported by NordVPN

  • Allows to hide countries in the map view

  • Allows to star a country in the map view

  • API keys stored in shared preferences are encrypted ("AES/GCM/NoPadding")

  • On app start, it will use a smart location, to determine the closest country

  • Uses Geolocation APIs to determine the current location based on the current public IP address

Am I missing some essential feature?

  • Submit an issue and let's make this app better together!

How it works

A lot of components make this app work, I'll cover some of the basics here. Basically on app startup, the map is loaded asynchronously, an MBTile file (SQLite database) located in the assets resource folder within the APK is loaded and then stored and read in memory. The world.mbtiles was generated using a custom python script, generate_tiles_multiprocess.py.

rm ./app/src/main/assets/world.mbtiles
python3 ./generate_tiles_multiprocess.py ./mapfile.xml ./app/src/main/assets/world.mbtiles 4 4 --format webp

After the map is done loading, the NordVPN API is invoked to query all the supported countries, filtering based on preferences such as server type is done here, markers are generated lazily for all the countries (markers are not placed on the map), all tiles (512x512 WebP images) are pre-loaded for the minimum zoom scale specified by the MBTile file. The current location is detected based on the public IP address of the client. The map then animates to the marker closest to this location. After animation completes, only the "lazy" markers whose location are within the visible bounds of the map are made visible (markers are placed on the map once they are made visible for the first time).

How to use

  • Install JuiceSSH
  • Add a new connection to Connections in JuiceSSH
  • Install this app
  • When prompted, enable/allow the permissions required by this app
  • Change any app settings as required
  • Select a Country by selecting a marker on the map
  • Click the colored floating action button (FAB), to send a Openpyn command to the remote device

Note: You can use this flow with multiple remote devices, as long as that remote device has a SSH server running on it and is configured in Connections in JuiceSSH and is selected in the app toolbar of this app before the colored floating action button (FAB) is clicked!

Screenshots

Download

The public beta is open to anyone.

Please use my test branch of Openpyn.

git clone --branch 2.2.1 [email protected]:1951FDG/openpyn-nordvpn.git
cd openpyn-nordvpn
pip3 install --upgrade .

Requirements

To compile and run the project you'll need:

References

Libraries used

Feedback

Feel free to send us feedback by submitting an issue. Bug reports, feature requests, patches, and well-wishes are always welcome.

Note: Pull requests are welcome. For major changes, please submit an issue first to discuss what you would like to change.

Credits

This app uses (modified) code from several open source projects.

Note: Special thanks to Yesy, author of Read SQLite Database from Android Asset Resource

Built with

Attributions

Acknowledgments

Many thanks to Sonelli who made this project possible and painless. Special thanks to Krystian Bigaj, author of SQLite-NDK.