We are building on the work of Taguette — go check them out! You will find close alignments between our code bases and even the installation instructions.

LibreQDA

LibreQDA is developed by the Plateforme en humanités numériques (PhuN) at Université de Sherbrooke.

This qualitative data analysis software (QDA) allows you to:

• Import PDFs, Word documents (.docx), text files (.txt), HTML, EPUB, MOBI, Open Documents (.odt), and Rich Text Files (.rtf).
• Highlight words, sentences or paragraphs and tag them with codes you create.
• Create hierarchical relations between your codes.
• Retrieve your tagged documents and lists of encoded sentences.
• Export you material in various formats for diffusion or post-processing with other tools.

Visit our website to consult the documentation.

Motivation and Goal

Through its collaborations with research teams and non-profit organizations across various fields, the team at PHuN has come to recognize the crucial need for developing rich, resilient and responsive ecosystem of open-source QDA software. Numerous testimonies highlight the disconnect between the commercial incentives of proprietary software and the core theories of substantive qualitative analysis. Today, users of QDA are subjected to forced obsolescence, costly licenses, black box features and data restrictions that prevent them from fully owning their intellectual product.

Our goal is to position LibreQDA as a valuable component within a diverse array of resources available to users seeking to develop a rich understanding of their textual data. We are committed to continuous improvement through community feedback and advocate for open integration with other tools to best meet your needs.

If you think LibreQDA could do something better, reach out!

Installation

A secure instance of LibreQDA running on Canadian servers is available at https://www.libreqda.org/. You can also install LibreQDA on your own computer or server: pre-built installers for Windows and macOS, along with pip and Docker options, are available on the Downloads page.

Desktop installers (Windows, macOS)

Grab the installer for your OS from the Downloads page:

• Windows — libreqda-setup.exe
• macOS — libreqda.dmg

Launch the app; a local instance opens in your browser. No account needed, your data stays on your machine.

pip

pip install libreqda
libreqda default-config > libreqda.conf
libreqda server libreqda.conf

Browse to localhost:7465.

Docker

docker pull phunudes/libreqda
docker run -d -p 7465:7465 -v libreqda-data:/data phunudes/libreqda

Browse to localhost:7465. Data persists in the libreqda-data volume.

Development Setup from the Repository

You can install from a local clone of this repository, which will allow you to easily change the sources to suit your needs. Taguette provide the base infrastructure for LibreQDA, which is reflected in these instructions:

1. Clone this git repository from the terminal: git clone https://gitlab.com/bin-cirst/libreqda/libre-qda/
2. Navigate on the command line to the repository you've just cloned locally, using the cd command. To get help using cd, use this tutorial.
3. LibreQDA uses Poetry for its packaging and dependency management. You will need to install Poetry.
4. Install LibreQDA and its dependencies by running poetry install. Poetry will create a virtual environment for you by default, activate it by running poetry shell.
   • To install dependencies for mysql or postgres, use the following command poetry install -E postgres.
5. Build translation files using scripts/update_translations.sh.
6. You can start LibreQDA in development mode using libreqda --debug (or libreqda --debug server <config_file>). This will start Tornado in debug mode, which means in particular that it will auto-restart every time you make changes.
   1. A config file can be created by running libreqda default-config > taguette.conf
7. Navigate to localhost:7465 to use LibreQDA!

Create custom theme

You can entirely configure LibreQDA interface by creating a theme.

1. Run poetry run make-theme [theme-name]. That will create 2 folders :
   • taguette/static/scss/themes/[theme-name] where the custom css are stored
   • taguette/templates/alt_templates/[theme-name] where you can override templates with the same hierarchy as in the templates folder
   • taguette/static/alt_templates/[theme-name] where you can put the files that you want to access in your custom template
2. Add this line in taguette.conf: THEME = "theme-name"

License

• Copyright (c) 2023, Plateforme en humanités numériques (Université de Sherbrooke) and contributors
• Copyright (c) 2018, Remi Rampin and Taguette contributors

Licensed under a BSD 3-clause "New" or "Revised" License. See the LICENSE.txt file for details.