Package: dragonion
🐲 dragonionMostmodern-looking,encryptedand functionalin-consoleonion chat
thatyoucontrol!📜 Table of Contents🐲 dragonion📜 Table of Contents📝 Note🛣️ Usage plan💻 Usage guide🔧 Configuration guide📃 Credits📝 Notedragonion IS NOT a chat for everyday use. It isspecificapplication focused onprivacyandsafety. It can contain functions, that you won't like or don't
contain some functions you would like to have in regular chat application.
You need to set up [dragonion-server]
by yourself or using existing server, hosted by your guild/organisation.
We don't provide any official servers.🛣️ Usage planCheck [📜 Table of Contents] (optionally)Read [📝 Note]Read [🛣️ Usage guide]Go to [⚙️ Configuration guide], choose your
platform, navigate to opted installation method (they are arranged from most to least
recommended)Make sure you have access to an up-to-date service provided by an administrator or
friends, or run your own personal service using the
[dragonion-server]Install pre-requirements, install app, run it,
checking [💻 Usage guide] if needed💻 Usage guideTo use dragonion-server, you need to install it first. To do this, you can visit
[Configuration guide].If you have questions that are not described in the documentation, you can chat with
[AI based on this repository]dragonion istextualapplication. It means, that it worksentirelyin the
terminal, while having amodern designand user experience that does not differ
from ordinary applications.When using the application, you will come across terms such asservicesandrooms.Servicesfrom the user's point of view isa pair of id-keyor.auth filethat you received from the administrator of your organization/guild or your friends.The so-calledroomsare sections of the service thatseparate usersand
make their communicationprivateby protecting the rooms with apassword.
Roomsdo not havea "correct" or "incorrect" password. Rooms with thesamename and password -the same room, rooms with the same name butdifferentpassword -differentrooms (similarly with other situations, to get intoone roomwith the interlocutors -everyonemust enter thesamename-password combination)Let's say that you have a friend who suggested you connect via encrypted dragonion chat.
In this case, friend most likely provided you with either two strings
(service id and auth string) or an .auth file. Below, we will figure out what to do in
each of these situations.If not, you will most likely have to start the server yourself.
It doesn't require any special programming or computer skills, but it can be a little
more difficult than starting a chat.
Check [dragonion-server] page to get
more information about starting your own dragonion service.After you have received the options for authentication, you need to install dragonion.
To do this, you can use the [🔧 Configuration guide] or ask
a question to [AI],
specifying your platform and choosing the appropriate installation method for yourself.With the program installed, you can proceed to launch and authenticate. If you have
an .auth file, you need to copy it to the working directory of the program or run
dragonion from the directory that contains this file. If there are authentication
strings, you just need to save them for yourself and paste them into the appropriate
fields at startup.Start app usingdragonioncommand or running executable, you will see user-friendly
interface. Remember, that if you do not understand any part of the interface,
you can always ask [AI] for help.dragonion also has cli options to automate startup.--author-aspecifies service name. Ifservice_name.authfile exists in working
directory, first screen with entering auth data will be skipped.--usernameor-uused to specify username to skip second screen of launch.--connector-cto start connecting right after application launch and entering
user and auth information.--dev-proxy-portis used for development and specifies local proxy port through
which the dragonion will connect to the torus to skip the step of starting the
internal proxy.Use/connectand/join room passwordcommands to manage connection. Also, you
can get in-application help using/helpcommand in chat input. If something is
unclear, use [AI] to figure out
what to do in this situation.🔧 Configuration guideYou can use [pipx] to install dragonion:pipx install dragonionOr download pre-built executable:🪟 Windows🐧 Linux🍎 MacOSIf you are missing something, you use non-x64 (ARM) or Android system or just want to
have more installation options, consider checking sections below.WindowsWindows guideThere are several different ways to install the program available, they are arranged
from the most convenient and easily updated, to the less obvious, but perhaps more
convenient for you:Single standalone executableSingle standalone executableThis method provides the ability to download a single executable file that leaves no
traces and is convenient for copying or using.Pre-requirements[Windows terminal] is recommended,
[install it from Microsoft Store]Fresh installation[Download latest version]Copy file in any folder and locate.authfiles in that folderLaunch optionsRun from commandline (Windows Terminal recommended) or by double-clicking executable.
If double-clicking,.authfiles need to be located near executable, if running from
commandline, they need to be located in workdir.UpdatingRe-download latest version from link above and replace the file.[Back to Usage guide]Installation scriptInstallation scriptThis method provides a way to install non-portable, but standalone application, using
one installation scriptPre-requirements[Windows terminal] is recommended,
[install it from Microsoft Store]Fresh installationUsing powershell, navigate to folder where you want to be dragonion installed. In
folder where you will run script,dragonionfolder will be created.Run:iwrhttps://s.kotikot.com/dragonion/w|iexAfter running this command, press Enter and wait.Launch optionsAfter installation finishes, script will output full installation path (with
executable name). You can paste it in terminal to run dragonion.Other option is to copydragonion.exefromdragonion\Scriptssomewhere and
launch it. But remember, that you cannot move installation folder, app isn't portable.UpdatingNavigate to folder, wheredragonioninstallation folder is located.Run:iwrhttps://s.kotikot.com/dragonion/wu|iexScript mirrors:Installation:iwrhttps://s.kotikot.com/dragonion/w|iexiwrhttps://github.com/dragonionx/dragonion/raw/master/scripts/w|iexiwrhttps://pastebin.com/raw/ix3LtZqj|iexUpdating:iwrhttps://s.kotikot.com/dragonion/wu|iexiwrhttps://github.com/dragonionx/dragonion/raw/master/scripts/wu|iexiwrhttps://pastebin.com/raw/Z28JDDMi|iex[Back to Usage guide]Using pipxUsing pipxThis method provides a way to install dragonion via pipx. It is very fast way of
installation and very convenient for using, but has some pre-requirements to install
on target system.Pre-requirements[Python3] (with pip)[pipx], relaunch shell after installationpipinstallpipx--userpython-mpipxensurepath[Windows terminal] is recommended,
[install it from Microsoft Store]Fresh installationpipxinstalldragonionLaunch optionsRundragonionin terminalUpdatingpipxupgradedragonion[Back to Usage guide]Python venv and pipPython venv and pipThis method provides a way of installation using python in virtual environment and
installing application from repo.Pre-requirements[Python3] (with pip)[Git][Windows terminal] is recommended,
[install it from Microsoft Store]Fresh installationgit clone https://github.com/dragonionx/dragonion
cd dragonion
python -m venv venv
venv\Scripts\activate
pip install .Launch optionsAfter fresh install, rundragonionin environment
(orpython -m dragonion)cdto app folder, runvenv\Scripts\activate, thandragonionin
environment (python -m dragonion)Rundragonion.exefromvenv\Scripts. You can also copy it anywhere you
want, but remember that data and config files are saved near executable fileUpdatingcdto app directory, thangit pullIf there are new changes, runvenv\Scripts\activate
pip install .[Back to Usage guide]Building from .whlBuilding from .whlThis method provides a way of installation using python in virtual environment and
installing application from repo.Pre-requirements[Python3] (with pip)[Windows terminal] is recommended,
[install it from Microsoft Store]Fresh installationDownload [latest wheel]python -m venv dragonion
dragonion\Scripts\activate
pip install dragonion-universal-py3-none-any.whlLaunch optionsAfter fresh install, rundragonionin environment
(orpython -m dragonion)cdto app folder, rundragonion\Scripts\activate, thandragonionin
environment (python -m dragonion)Rundragonion.exefromdragonion\Scripts. You can also copy it anywhere you
want, but remember that data and config files are saved near executable fileUpdatingDownload [latest wheel]dragonion\Scripts\activate
pip install dragonion-universal-py3-none-any.whl[Back to Usage guide]LinuxLinux guideInstallation methods depend on your processor architecture. Choose the one that suits 
you. In sections, different ways to install the program are arranged
from the most convenient and easily updated, to the less obvious, but perhaps more
convenient for you:x64Using pipxUsing pipxThis method provides a way to install dragonion via pipx. It is very fast way of
installation and very convenient for using.Pre-requirementspython3,python3-pip,python3-venvFresh installationInstall pipx and relaunch shellpip install pipx --user
python3 -m pipx ensurepathInstall dragonionpipx install dragonionLaunch optionsRundragonionin terminalUpdatingpipxupgradedragonion[Back to Usage guide]Single standalone executableSingle standalone executableThis method provides the ability to download a single executable file that leaves no
traces and is convenient for copying or using.Pre-requirementsNo special requirements found on regular distrosFresh installation[Download latest version]Copy file in any folder and locate.authfiles in that folderLaunch optionsRun from commandlinedragonion-linux,.authfiles should be located in workdirUpdatingRe-download latest version from link above and replace the file.[Back to Usage guide]Installation scriptInstallation scriptThis method provides a way to install non-portable, but standalone application, using
one installation script.Pre-requirementspython3python3-pippython3-venvwgetFresh installationUsing your shell, navigate to directory where you want to be dragonion installed. In
folder where you will run script,dragoniondir will be created.Run:.<(wget-qO-https://s.kotikot.com/dragonion/l)After running this command, press Enter and wait.Launch optionsAfter installation finishes, script will output full installation path (with
executable name). You can paste it in terminal to run dragonion.Also, after installation you will be in dragonion environment, so you can rundragonionas command. To deactivate it, you can rundeactivate, and to activate
again, use. dragonion/bin/activateOther option is to copydragonionfromdragonion\binsomewhere and
launch it. But remember, that you cannot move installation dir, app isn't portable.UpdatingNavigate to directory, wheredragonioninstallation dir is located.Run:.<(wget-qO-https://s.kotikot.com/dragonion/lu)Script mirrors:Installation:.<(wget-qO-https://s.kotikot.com/dragonion/l).<(wget-qO-https://github.com/dragonionx/dragonion/raw/master/scripts/l).<(wget-qO-https://pastebin.com/raw/LdrRBEYB)Updating:.<(wget-qO-https://s.kotikot.com/dragonion/lu).<(wget-qO-https://github.com/dragonionx/dragonion/raw/master/scripts/lu).<(wget-qO-https://pastebin.com/raw/XRSA9wUz)[Back to Usage guide]Python venv and pipPython venv and pipThis method provides a way of installation using python in virtual environment and
installing application from repo.Pre-requirementspython3python3-pippython3-venvgitFresh installationgit clone https://github.com/dragonionx/dragonion
cd dragonion
python3 -m venv venv
. venv\bin\activate
pip install .Launch optionsAfter fresh install, rundragonionin environment
(orpython3 -m dragonion)cdto app folder, run. venv\bin\activate, thandragonionin
environment (python3 -m dragonion)Rundragonionfromvenv\bin. You can also copy it anywhere you
want, but remember that data and config files are saved near executable fileUpdatingcdto app directory, thangit pullIf there are new changes, run. venv\bin\activate
pip install .[Back to Usage guide]Building from .whlBuilding from .whlThis method provides a way of installation using python in virtual environment and
installing application from repo.Pre-requirementspython3python3-pippython3-venvFresh installationDownload [latest wheel]python3 -m venv dragonion
. dragonion\bin\activate
pip install dragonion-universal-py3-none-any.whlLaunch optionsAfter fresh install, rundragonionin environment
(orpython3 -m dragonion)cdto app folder, run. dragonion\bin\activate, thandragonionin
environment (python3 -m dragonion)Rundragonionfromdragonion\bin. You can also copy it anywhere you
want, but remember that data and config files are saved near executable fileUpdatingDownload [latest wheel]. dragonion\bin\activate
pip install dragonion-universal-py3-none-any.whl[Back to Usage guide]armARMTor does not provide expert bundles for arm systems (except macOS).
You need to installtorthrough your package manager, which is indicated in the
pre-requirementsUsing pipxUsing pipxThis method provides a way to install dragonion via pipx. It is very fast way of
installation and very convenient for using.Pre-requirementspython3,python3-pip,python3-venvtorFresh installationInstall pipx and relaunch shellpip install pipx --user
python3 -m pipx ensurepathInstall dragonionpipx install dragonionLaunch optionsRundragonionin terminalUpdatingpipxupgradedragonion[Back to Usage guide]Installation scriptInstallation scriptThis method provides a way to install non-portable, but standalone application, using
one installation script.Pre-requirementspython3python3-pippython3-venvwgettorFresh installationUsing your shell, navigate to directory where you want to be dragonion installed. In
folder where you will run script,dragoniondir will be created.Run:.<(wget-qO-https://s.kotikot.com/dragonion/l)After running this command, press Enter and wait.Launch optionsAfter installation finishes, script will output full installation path (with
executable name). You can paste it in terminal to run dragonion.Also, after installation you will be in dragonion environment, so you can rundragonionas command. To deactivate it, you can rundeactivate, and to activate
again, use. dragonion/bin/activateOther option is to copydragonionfromdragonion\binsomewhere and
launch it. But remember, that you cannot move installation dir, app isn't portable.UpdatingNavigate to directory, wheredragonioninstallation dir is located.Run:.<(wget-qO-https://s.kotikot.com/dragonion/lu)Script mirrors:Installation:.<(wget-qO-https://s.kotikot.com/dragonion/l).<(wget-qO-https://github.com/dragonionx/dragonion/raw/master/scripts/l).<(wget-qO-https://pastebin.com/raw/LdrRBEYB)Updating:.<(wget-qO-https://s.kotikot.com/dragonion/lu).<(wget-qO-https://github.com/dragonionx/dragonion/raw/master/scripts/lu).<(wget-qO-https://pastebin.com/raw/XRSA9wUz)[Back to Usage guide]Python venv and pipPython venv and pipThis method provides a way of installation using python in virtual environment and
installing application from repo.Pre-requirementspython3python3-pippython3-venvgittorFresh installationgit clone https://github.com/dragonionx/dragonion
cd dragonion
python3 -m venv venv
. venv\bin\activate
pip install .Launch optionsAfter fresh install, rundragonionin environment
(orpython3 -m dragonion)cdto app folder, run. venv\bin\activate, thandragonionin
environment (python3 -m dragonion)Rundragonionfromvenv\bin. You can also copy it anywhere you
want, but remember that data and config files are saved near executable fileUpdatingcdto app directory, thangit pullIf there are new changes, run. venv\bin\activate
pip install .[Back to Usage guide]Building from .whlBuilding from .whlThis method provides a way of installation using python in virtual environment and
installing application from repo.Pre-requirementspython3python3-pippython3-venvtorFresh installationDownload [latest wheel]python3 -m venv dragonion
. dragonion\bin\activate
pip install dragonion-universal-py3-none-any.whlLaunch optionsAfter fresh install, rundragonionin environment
(orpython3 -m dragonion)cdto app folder, run. dragonion\bin\activate, thandragonionin
environment (python3 -m dragonion)Rundragonionfromdragonion\bin. You can also copy it anywhere you
want, but remember that data and config files are saved near executable fileUpdatingDownload [latest wheel]. dragonion\bin\activate
pip install dragonion-universal-py3-none-any.whl[Back to Usage guide]MacOSMacOS guideUsing pipxUsing pipxThis method provides a way to install dragonion via pipx. It is very fast way of
installation and very convenient for using.Pre-requirementspython3,python3-pip,python3-venvFresh installationInstall pipx and relaunch shellbrew install pipx
pipx ensurepathInstall dragonionpipx install dragonionLaunch optionsRundragonionin terminalUpdatingpipxupgradedragonion[Back to Usage guide]Single standalone executableSingle standalone executableThis method provides the ability to download a single executable file that leaves no
traces and is convenient for copying or using.Pre-requirementsNo special requirements found on regular distrosFresh installation[Download latest version]Copy file in any folder and locate.authfiles in that folderLaunch optionsRun from commandlinedragonion-darwin,.authfiles should be located in workdirUpdatingRe-download latest version from link above and replace the file.[Back to Usage guide]Installation scriptInstallation scriptThis method provides a way to install non-portable, but standalone application, using
one installation script.Pre-requirementspython3python3-pippython3-venvwgetcurlFresh installationUsing your shell, navigate to directory where you want to be dragonion installed. In
folder where you will run script,dragoniondir will be created.Run:bash<(curl-sLhttps://s.kotikot.com/dragonion/m)After running this command, press Enter and wait.Launch optionsAfter installation finishes, script will output full installation path (with
executable name). You can paste it in terminal to run dragonion.Also, after installation you will be in dragonion environment, so you can rundragonionas command. To deactivate it, you can rundeactivate, and to activate
again, use. dragonion/bin/activateOther option is to copydragonionfromdragonion\binsomewhere and
launch it. But remember, that you cannot move installation dir, app isn't portable.UpdatingNavigate to directory, wheredragonioninstallation dir is located.Run:bash<(curl-sLhttps://s.kotikot.com/dragonion/lu)Script mirrors:Installation:bash<(curl-sLhttps://s.kotikot.com/dragonion/m)bash<(curl-sLhttps://github.com/dragonionx/dragonion/raw/master/scripts/m)bash<(curl-sLhttps://pastebin.com/raw/4whxpEFD)Updating:bash<(curl-sLhttps://s.kotikot.com/dragonion/mu)bash<(curl-sLhttps://github.com/dragonionx/dragonion/raw/master/scripts/mu)bash<(curl-sLhttps://pastebin.com/raw/DkPhhTyv)[Back to Usage guide]Python venv and pipPython venv and pipThis method provides a way of installation using python in virtual environment and
installing application from repo.Pre-requirementspython3python3-pippython3-venvgitFresh installationgit clone https://github.com/dragonionx/dragonion
cd dragonion
python3 -m venv venv
. venv\bin\activate
pip install .Launch optionsAfter fresh install, rundragonionin environment
(orpython3 -m dragonion)cdto app folder, run. venv\bin\activate, thandragonionin
environment (python3 -m dragonion)Rundragonionfromvenv\bin. You can also copy it anywhere you
want, but remember that data and config files are saved near executable fileUpdatingcdto app directory, thangit pullIf there are new changes, run. venv\bin\activate
pip install .[Back to Usage guide]Building from .whlBuilding from .whlThis method provides a way of installation using python in virtual environment and
installing application from repo.Pre-requirementspython3python3-pippython3-venvFresh installationDownload [latest wheel]python3 -m venv dragonion
. dragonion\bin\activate
pip install dragonion-universal-py3-none-any.whlLaunch optionsAfter fresh install, rundragonionin environment
(orpython3 -m dragonion)cdto app folder, run. dragonion\bin\activate, thandragonionin
environment (python3 -m dragonion)Rundragonionfromdragonion\bin. You can also copy it anywhere you
want, but remember that data and config files are saved near executable fileUpdatingDownload [latest wheel]. dragonion\bin\activate
pip install dragonion-universal-py3-none-any.whl[Back to Usage guide]AndroidTermux guideDue to the nature of Termux, installation can be a little tricky, so we have simplified
the installation process for you by creating a specific pre-requirements termux guide.pkg install python python-pip libexpat git rust binutils tor
pkg upgradeNow, navigate to [guide for Linux ARM systems]
(Linux-> arm) and choose desired installation
way. They all apply for termux also if pre-requirements above are installed.📃 Credits[OnionShare project] - code inspiration for
integrating application with tor