dynalist_companion | Unofficial utilities for the dynalist.io list management

Clone the project or download and extract archive from our github repository. This installation will let you use and develop the software. If you want to install the software for productive use on a web server, also follow the additional steps in the section after this one. The instructions assume a Debian / Ubuntu system – the software is cross-platform though and runs wherever Python runs.
Make sure you have the right Python version (3.6 or higher): $ python --version $ python3 --version $ python3.6 --version The first command that shows its version as 3.6 is the right one to use below (we'll use python3.6 always and be on the safe side). Maybe you have to install it first. Ubuntu 16.04 LTS for example provides only Python 3.5, which will not work – fix it as follows (source): $ sudo add-apt-repository ppa:deadsnakes/ppa $ sudo apt update $ sudo apt install python3.6
Make sure you have installed the Python Package Manager, aka pip. If necessary, install it. If you have Python 3.6 installed from your default operating system packages (Ubuntu 16.10 and higher), you can just do: $ sudo apt install python3-pip # Check if PIP is installed now: $ python3.6 -m pip --version # The output should be like this: pip 18.0 from …/lib/python3.6/site-packages/pip (python 3.6) Otherwise, if you followed the above instructions for Ubuntu 16.04, you'd do this: $ curl https://bootstrap.pypa.io/get-pip.py | sudo python3.6
Create a Python virtual environment It is often useful to have one or more Python environments where you can experiment with different combinations of packages without affecting your main installation. Python supports this through virtual environments. The virtual environment is a copy of an existing version of Python with the option to inherit existing packages. (A virtual environment is also useful when you need to work on a shared host system and do not have permission to install packages system-wide, as you will still be able to install them in the virtual environment.) Change into your project directory. This would be a directory like /path/to/your/project/, not the /path/to/your/project/dynalist_companion/ subdirectory that contains the actual source code. This step is essential, as the Python virtual environment (links to Python executables etc.) will be installed here. Install the virtualenv package: $ pip3.6 install virtualenv Initialize the virtual environment: $ virtualenv venv Activate the virtual environment: $ source venv/bin/activate Output should be like: $ (venv) user@host:~/projects/dynalist_companion
Install PIP 18.0.1 inside the virtual environment. Otherwise installation won't be succeed with pip 10.0.1 or lower (unknown reason).
Run the setup script: We value your time, so we made the setup process easy :-) You don't have to run any other commands for setup now. $ cd dynalist_companion/ $ python3.6 setup.py install
Save the secret code and admin details generated by setup.py to share it later with those you want to allow to registrar. You can change the secret code at any time by in admin panel. For convention details generated are saved into root directory named as for_admin.txt.
Fill in your Dynalist API secret token into admin panel by logging into your admin account. (You should use the API secret token of a Dynalist account that has read-only access to the Dynalist file you want to use with ths software, and none beyond that. Means, set up a Dynalist account for your team. Don't just use your personal one, because that would give this software, and everyone with access to the server you install it on, access to all your other Dynalist documents as well, including personal ones. Also don't give the account used by this software write access to your documents in the Dynalist "Manage Sharing …" settings. It is not necessary and would only create the danger that software bugs could delete that file's content.)
In Admin panel, fill the file ID of the Dynalist file that Dynalist Companion should observe. Right now, only a single file is supported. You can find out the file ID by opening the file in Dynalist and copying out the part of the URL from the browser's address bar that is behind https://dynalist.io/d/ and before the # (if any).
Fill in the credentials of an e-mail account to use for sending out the notifications into Admin panel.
Dynalist companion supports automated backup system for dynalist node, as per id specified in Admin panel. Setup cron job to execute backup.py and you are ready to go. Backup file will saved per hit inside PROJECT_DIR'/resources/dynalist_backup by default which can be changed from config.py. Google drive integration: (Follow these steps on local machine and later move files to remote host.).
Login to your admin account and goto admin panel.
Check "enable backup" to enable. (disabled by default.)
Select preferred backup system. (defaults to local disk, for google drive integration follow steps below)
Create project or choose existing one and enable drive api for your app.
Click DOWNLOAD CLIENT CONFIGURATION which will download credentials.json and move it to project's resources directory.
Enable Backup system to google drive in Admin panel (default to local disk).
Execute backup.py, new instance of browser tab will open. ($ python admin.py backup)
Give drive access to your app and token.json file will saved to your project's backup package's directory.
Move token.json to resources directory.
Move all above files to files to remote host.