Skip to content

mortbauer/QualCoder

 
 

Repository files navigation

QualCoder

QualCoder is a qualitative data analysis application written in python3 and pyqt5.

QualCoder projects are stored in a Sqlite database. Text files can be typed in manually or loaded from txt, odt, docx, epub and pdf files. Images, video and audio can also be imported for coding. Codes can be assigned to text, images and a/v selections and grouped into categories in hierarchical fashion. Various types of reports can be produced including visual coding graphs, coder comparisons and coding frequencies.

This project has been tested under Ubuntu, Linux Mint 18 and Windows 10, partly tested on Lubuntu 16. It has not been throughly tested on Mac OS. Instructions and other information are available here: https://qualcoder.wordpress.com/ and on the Github Wiki.

INSTALLATION

You will need to have a python3.x version installed. You will also need to have pyqt5 and lxml to get text from docx files. You will also need to have a vlc player installed - for audio and video. On Windows, the bit version of VLC, 32 or 64 must match the bit version of python 3.

Linux:

I have created a .deb package for QualCoder which can be installed into Debian/Ubuntu systems. This will install the QualCoder software by double-clicking on the .deb package. It is not a perfect package so you might have to re-install it to get it to install correctly.

Manual install on Linux:

Once a python 3.x is installed, make the install.sh executable and run the install.sh script from the terminal. Make sure the qualcoder folder is in the same directory as the install.sh script (i.e. as it appears when you download the QualCoder-master folder).

./install.sh

The qualcoder folder should be in te same directory as the install.sh script.

This will install QualCoder in the /usr/share directory and create a launcher. Alternatively move to the qualcoder directory and run the qualcoder.py file in a terminal: python3 qualcoder.py

Windows:

Install Python3 and VLC or from the Windows Store.

Install dependencies in the command prompt:

python -m pip install pyqt5, lxml, Pillow, six

To launch, you can create a shortcut to the qualcoder.py file to start QualCoder.

Alternatively move to the qualcoder directory and run the qualcoder.py file in a terminal: python3 qualcoder.py

CURRENT WINDOWS ISSUE: working with audio/video requires a missing dll module. So I have also added a qualcoder_non_av folder which will run qualcoder for text and images. You wont be able to code or view audio or video. I believe the problem is based on whether you have both 32 bit python and vlc install or 64 bit python and vlc installed. If one is 32 bit and the other is 64 bit, python and vlc will not be compatable.

MacOS

Install Python3 and VLC.

Install the Python dependencies using pip:

pip install pyqt5 lxml pillow six

There is no desktop icon launch right now for QualCoder. Open a new Terminal window in the directory and launch with python qualcoder.py.

Dependencies

Required

  • Python 3.x version

  • PyQt5

  • lxml

  • Pillow

  • vlc

Issues

  • Testing has only been performed on Ubuntu and Linux Mint and for a large part on Windows 10. Some usage conducted with Lubuntu and Apple MacOSX.

Future plans

  • Reports:
    • Word count report
    • Possibly look at text mining
  • Text mining
    • word cloud, word visualisations
  • General
    • Translations for GUI (some translations in Gernam and French).

License

QualCoder is distributed under the MIT LICENSE.

About

Qualitative data analysis software written in python3 and pyqt5

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • HTML 79.9%
  • Python 20.1%