Bring order to your research — use the power of Tropy to organize and describe your research photos so you can quickly find your sources whenever you need them.
Visit tropy.org to learn more or follow @tropy on Twitter for important announcements. To get started, download the latest version of Tropy for your platform, check out the user's manual and join the discussion on the forums.
If you are interested to work on Tropy or create your own builds, please find more details below. Happy hacking!
Install the latest version of Node.js (at least the
version that ships with the current Electron
release) and all requirements needed to use
node-gyp
on your platform.
On Linux you may need to install some packages in addition to node-gyp's requirements. For example:
# On Arch Linux
$ sudo pacman -Sy fftw orc librsvg
# On Debian
$ sudo apt-get install liborc-0.4-0 libfftw3-bin librsvg2-bin
# On CentOS
$ sudo yum install fftw3 orc librsvg2 glib2-devel
Before installing Tropy's dependencies, set the environment variable
SHARP_DIST_BASE_URL
or the sharp_dist_base_url
npm config option to
point to the base URL for Tropy's
pre-compiled libvips archives:
$ npm config set sharp_dist_base_url "https://github.com/tropy/sharp-libvips/releases/download/v8.8.1-tropy/"
Additionally, if you have libvips installed locally (and don't wish Tropy
to be linked against it), set the SHARP_IGNORE_GLOBAL_LIBVIPS
environment
variable.
Finally, clone this repository and install all of Tropy's dependencies:
# Install native modules first, without building, them. They will
# be patched and linked against Electron by our rebuild script later!
$ npm install sharp sqlite3 --ignore-scripts --no-save --no-package-lock
$ npm install
To test that everything is set up correctly, run:
$ npm test
To create a dev-build for your current platform run npm run build
at the
root of the repository. This will create a dev-build of Tropy in the dist
folder.
Alternatively, you can start Tropy in dev-mode directly from the root of the
repository, by running npm start
.