Installation

The following instructions assume that you are using either Ubuntu linux OR Ubuntu through the Windows Subsystem for Linux (Windows 10).

Important

The described installation method for Windows requires Windows 10+. Direct installation on Mac OS is possible but not tested.

Enable WSL (Windows only)

On Windows, you will need to enable Windows Subsystem for Linux (wsl). Go to Control Panel > Programs > Programs and Features > Turn Windows Features On and Off, then check “Windows Subsystem for Linux”.

Now go to the Windows start menu and type “Ubuntu”, which should locate Ubuntu in the Windows App Store. Follow the prompts to install Ubuntu Linux and create a user account.

Run the installer script

Download odea_install.sh and, if you are using Windows, the batch command script odea_install.cmd.

On Windows, put both files in the same directory and double-click the Windows install file (odea_install.cmd). On Linux, just run the bash file directly.

The Windows installer contains the following script:

@ECHO OFF
wsl sudo odea_install.sh
pause

The shell script contains the following:

#!/usr/bin/sh

apt install \
  python3 \
  python3-pip \
  pandoc \
  imagemagick \
  libreoffice \
  wkhtmltopdf \
  inkscape \
  ffmpeg

# preview generator
apt install \
  scribus \
  python3-pythonmagick \
  zlib1g-dev \
  libjpeg-dev \
  xvfb \
  poppler-utils \
  libfile-mimeinfo-perl \
  qpdf \
  libimage-exiftool-perl \
  ufraw-batch

pip3 install odea

Odea drop targets

The simplest way of using odea is through scripts that wrap the command-line interface.

The following provided scripts can be used as drop-targets for processing archive files, and can be stored anywhere on your computer that is convenient. Documents to be processed by odea simply need to be dragged and dropped onto the script file in the file explorer.

Windows version of the “update” script (odea_update.cmd):

:: This is a drop target for files to be processed by odea in a linux shell

@ECHO OFF
for %%i in (%*) do (

@ECHO %%i
wsl I=`wpc %%i`; odea --update --derive --filename "$I"
)
pause

Linux version of the “update” script (odea_update.sh):

#!/usr/bin/sh
# This is a drop target for files to be processed by odea in a linux shell
for i in "$@"; do
 echo $i
 odea --update --derive --filename "$i"
done

If using the Publish script, you will need to update the variables at the top to suit your installation. Here is a Windows version of the “publish” script (odea_publish.cmd):

:: This is a drop target for files to be processed by odea in a linux shell

@ECHO OFF
for %%i in (%*) do (

@ECHO %%i
wsl I=`wpc %%i`; odea --publish --filename="$I";
)

wsl I=`wpc %1`; odea --index --filename="$I";

pause

Context menu scripts

It is also possible to add any of these scripts to the “Send To” context menu on Windows. To do so, type shell:sendto in the location bar of the File Explorer, then create shortcuts to the odea scripts in the folder that opens up.

_images/sendto-menu.png