You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Instructions d'installation et d'exécution de QualCoder
2
2
3
-
## INSTALLATION
3
+
## INSTALLATION
4
4
5
-
For the manual installations (using the command line or terminal) I mention a specific release version, for example version 3.6. Please check on the [releases page](https://github.com/ccbogel/QualCoder/releases)for the most current version, as it may be newer.
5
+
Pour les installations manuelles (via la ligne de commande ou le terminal), je mentionne une version spécifique, par exemple la version 3.6. Veuillez vérifier sur la [page des versions](https://github.com/ccbogel/QualCoder/releases)pour obtenir la version la plus récente, qui peut être plus avancée.
6
6
7
-
### Prerequisites
8
-
VLC is optional, but you will need it installed if you need to do any audio/video coding. Optionally, install ffmpeg for speech to text and waveform display, see https://phoenixnap.com/kb/ffmpeg-windows..
7
+
### Prérequis
8
+
VLC est optionnel, mais nécessaire si vous souhaitez effectuer du codage audio/vidéo. Optionnellement, installez ffmpeg pour la conversion parole-texte et l'affichage des formes d'onde, voir [phoenixnap.com/kb/ffmpeg-windows](https://phoenixnap.com/kb/ffmpeg-windows).
9
9
10
-
### Windows
11
-
12
-
See [https://github.com/ccbogel/QualCoder/releases/3.7](https://github.com/ccbogel/QualCoder/releases/3.7)
10
+
---
13
11
14
-
You have two options for executables, created on Windows 11, and may work on Windows 10:
12
+
### Windows
15
13
16
-
- There is a Windows installer on the release page called: **QualCoder.Win.3.7.exe**
- There is a standalone, non-installable exe folder called: **QualCoder.Win.3.7.Portable.zip** Download and unzip. It is in a folder alongside an internal folder. These both must be together or the exe will not run. Double-click the QualCoder exe to run, it takes up to 20 seconds to start.
16
+
Vous avez deux options pour les exécutables, créés sous Windows 11 et pouvant fonctionner sous Windows 10 :
- Un installateur Windows est disponible sur la page des versions : **QualCoder.Win.3.7.exe**
21
19
22
-
On first use of the exe, Windows may ask you to allow to run QualCoder. This is because it is from an unknown publisher. It costs a lot of money to get a trusted publisher certificate - so that will not be possible for the foreseeable future. If you are uncomfortable with these warnings install from the source as detailed next.
20
+
- Une version portable, non installable, est disponible sous forme de dossier zip : **QualCoder.Win.3.7.Portable.zip**. Téléchargez et décompressez-le. Le fichier exécutable se trouve dans un dossier, accompagné d'un sous-dossier interne. Ces deux éléments doivent rester ensemble pour que l'exécutable fonctionne. Double-cliquez sur l'exécutable QualCoder pour le lancer (le démarrage peut prendre jusqu'à 20 secondes).
Download the source code. Read and apply the section for Windows source code usage in the **Readme.md** file.
27
-
Remove the back ticks that surround the command line instructions ` as these are used for display only.
25
+
Lors de la première utilisation, Windows peut vous demander d'autoriser l'exécution de QualCoder, car il provient d'un éditeur inconnu. Obtenir un certificat d'éditeur de confiance coûte cher, ce qui n'est pas envisageable pour l'instant. Si ces avertissements vous gênent, installez-le à partir du code source comme détaillé ci-dessous.
28
26
29
-
### MacOS
27
+
**Installation alternative à partir du code source :**
28
+
Téléchargez le code source. Lisez et appliquez la section dédiée à l'utilisation du code source sous Windows dans le fichier **Readme.md**.
29
+
Supprimez les backticks (`) entourant les instructions de ligne de commande, car elles ne servent qu'à l'affichage.
30
30
31
-
**Install from App bundles:**
31
+
---
32
32
33
-
Make sure you have installed any MAC OS updates before starting the installation. Go to the System Settings app on your Mac. Click General in the sidebar (you may need to scroll down), then click Software Update.
33
+
### macOS
34
34
35
-
Install QualCoder: Double-click the downloaded dmg-file. Drag QualCoder into the link to your applications.
35
+
**Installation via les bundles d'application :**
36
36
37
-
Start QualCoder from your Launchpad or by double-clicking the app within your applications folder.
38
-
We are currently not able to sign the app bundles, so when you first try to run the program, you may get a pop-up warning that QualCoder is from an unregistered developer or "QualCoder can't be opened because Apple cannot check it for malicious software." Depending on your processor, you may see one of these:
37
+
Assurez-vous d'avoir installé toutes les mises à jour macOS avant de commencer. Allez dans l'application Réglages système de votre Mac. Cliquez sur Général dans la barre latérale (il peut être nécessaire de faire défiler), puis sur Mise à jour logicielle.
39
38
40
-
If you see "Show in Finder" or OK. Click Ok.
39
+
Pour installer QualCoder :
40
+
Double-cliquez sur le fichier .dmg téléchargé. Glissez QualCoder vers le lien de votre dossier Applications.
41
41
42
-
If you see "Done" or "Move to trash. Click "Done.
42
+
Lancez QualCoder depuis le Launchpad ou en double-cliquant sur l'application dans votre dossier Applications.
43
+
Nous ne pouvons pas actuellement signer les bundles d'application. Lors du premier lancement, un message peut apparaître indiquant que QualCoder provient d'un développeur non enregistré ou que "QualCoder ne peut pas être ouvert car Apple ne peut pas vérifier l'absence de logiciels malveillants". Selon votre processeur, vous verrez l'une de ces options :
43
44
44
-
Next, go to Settings and select Privacy and Security. Scroll down until you see a message stating QualCoder was prevented from starting. Click on "open anyway". You may be prompted to enter your password and may need to click "Open" again. After entering your password, just wait for the program to open up. It may take several seconds.
45
+
- Si vous voyez "Afficher dans le Finder" ou OK, cliquez sur OK.
46
+
- Si vous voyez "Terminé" ou "Placer dans la corbeille", cliquez sur "Terminé".
45
47
46
-
From now on, QualCoder should start without issues.
48
+
Ensuite, allez dans Réglages > Confidentialité et sécurité. Faites défiler jusqu'à voir un message indiquant que QualCoder a été empêché de s'ouvrir. Cliquez sur "Ouvrir quand même". Vous devrez peut-être entrer votre mot de passe et cliquer à nouveau sur "Ouvrir". Après avoir entré votre mot de passe, attendez quelques secondes que le programme se lance.
47
49
48
-
**Install from source code:**
50
+
Désormais, QualCoder devrait démarrer sans problème.
49
51
50
-
Download the source code. Read and apply the section for masOC source code usage in the **Readme.md** file.
51
-
Remove the back ticks that surround the command line instructions ` as these are used for display only.
52
+
**Installation à partir du code source :**
53
+
Téléchargez le code source. Lisez et appliquez la section dédiée à l'utilisation du code source sous macOS dans le fichier **Readme.md**.
54
+
Supprimez les backticks (`) entourant les instructions de ligne de commande, car elles ne servent qu'à l'affichage.
52
55
56
+
---
53
57
54
58
### Debian/Ubuntu Linux
55
59
56
-
There is an executable file in the releases page for Ubuntu 24.04 for the 3.6 release. Download and double click to run.
60
+
Un fichier exécutable est disponible sur la page des versions pour Ubuntu 24.04 (version 3.6). Téléchargez-le et double-cliquez pour l'exécuter.
57
61
58
-
Alternatively, run QualCoder from the source code:
62
+
**Exécution à partir du code source :**
63
+
Téléchargez le code source. Lisez et appliquez la section dédiée à l'utilisation du code source sous Ubuntu dans le fichier **Readme.md**.
64
+
Supprimez les backticks (`) entourant les instructions de ligne de commande, car elles ne servent qu'à l'affichage.
59
65
60
-
Download the source code. Read and apply the section for Ubuntu source code usage in the **Readme.md** file.
61
-
Remove the back ticks that surround the command line instructions ` as these are used for display only.
66
+
---
62
67
63
68
### Fedora 43
64
69
65
-
These instructions are tested with QualCoder 3.7 on Fedora 43 with Python 3.12.12.
70
+
Ces instructions ont été testées avec QualCoder 3.7 sur Fedora 43 avec Python 3.12.12.
66
71
67
-
Install dependencies:
72
+
Installez les dépendances :
68
73
69
74
`sudo dnf install python3.12`
70
75
71
-
Set up QualCoder:
76
+
Configurez QualCoder:
72
77
73
-
`cd ~/qualcoder # replace with appropriate location on your machine`
78
+
`cd ~/qualcoder # remplacez par l'emplacement approprié sur votre machine`
74
79
75
80
`python3.12 -m venv env`
76
81
@@ -86,9 +91,9 @@ Set up QualCoder:
86
91
87
92
`deactivate`
88
93
89
-
Usage:
94
+
Utilisation :
90
95
91
-
`cd ~/qualcoder # replace with appropriate location on your machine`
96
+
`cd ~/qualcoder # remplacez par l'emplacement approprié sur votre machine`
92
97
93
98
`source env/bin/activate`
94
99
@@ -98,15 +103,14 @@ Usage:
98
103
99
104
### Fedora 42
100
105
101
-
These instructions download the current source code directly from GitHub. Note: Fedora uses Wayland which may not work well with the Qt graphical interface. It is suggested you also install Xwayland.
106
+
Ces instructions permettent de télécharger le code source actuel directement depuis GitHub. Remarque : Fedora utilise Wayland, qui peut ne pas fonctionner correctement avec l'interface graphique Qt. Il est recommandé d'installer également Xwayland.
102
107
103
-
Download the source code. Read and apply the section for Fedora source code usage in the **Readme.md** file.
104
-
Remove the back ticks that surround the command line instructions ` as these are used for display only.
108
+
Téléchargez le code source. Lisez et appliquez la section relative à l'utilisation du code source Fedora dans le fichier **Readme.md**.
109
+
Supprimez les guillemets inversés qui entourent les instructions de la ligne de commande `, car ils ne servent qu'à l'affichage.
105
110
106
-
There may be problems with QualCoder working with audio / video in Fedora.
111
+
QualCoder peut rencontrer des problèmes avec l'audio/vidéo sous Fedora.
107
112
108
113
### Arch/Manjaro Linux
109
114
110
-
Download the source code. Read and apply the section for Arch source code usage in the **Readme.md** file.
111
-
Remove the back ticks that surround the command line instructions ` as these are used for display only.
112
-
115
+
Téléchargez le code source. Lisez et appliquez la section relative à l'utilisation du code source Arch dans le fichier **Readme.md**.
116
+
Supprimez les guillemets inversés qui entourent les instructions de la ligne de commande `, car ils ne servent qu'à l'affichage.
La boîte de dialogue des paramètres permet de modifier plusieurs fonctionnalités, notamment la langue, le nom du codeur, le type et la taille de la police, ainsi que les options d'intégration de l'IA.
3
4
4
-
The settings dialog allows you to change several features including language, coder name and font type and font size, as well as options for the AI integration.
5
+
Plusieurs codeurs peuvent coder le même texte. Un nouveau nom de codeur peut être saisi dans la zone de texte. Vous pouvez également choisir un codeur existant dans la liste déroulante. Le nom du codeur est défini par défaut sur « default » lors de la première utilisation de QualCoder. Lors de l'ouverture d'un autre projet existant, assurez-vous que le nom du codeur est bien défini sur le nom que vous souhaitez utiliser en vérifiant et en mettant à jour les paramètres avant de travailler sur votre projet.
5
6
6
-
Multiple coders can code the same text. A new coder name can be entered in the text box. You can choose an existing coder from the drop down box. The coder name is 'default' when first using QualCoder. When opening another existing project, please make sure the coder name is set to the name you want to use by checking and updating the Settings before you do work on your project. Please note that only the current coder name is specially stored. If you enter a series of coder names in settings, new coder names are not stored, unless they are actively used, i.e. by importing a file, creating a code, coding text etc.
7
+
La langue par défaut de QualCoder est l'anglais. Actuellement, le français, l'allemand, l'italien, le portugais et l'espagnol sont disponibles comme langues alternatives. Ces traductions n'ont pas été entièrement vérifiées pour leur exactitude. Lorsque vous changez de langue, vous devez fermer puis rouvrir QualCoder pour que le changement prenne effet.
7
8
8
-
The default language of QualCoder is English. Chinese, French, German, Italian, Japanese, Portuguese and Spanish, Swedish are alternative languages. Some languages have not been thoroughly reviewed for accuracy of translations. When changing a language, you need to close then reopen QualCoder for the change to occur.
9
+
En cochant la case **Afficher les identifiants**, les identifiants numériques des codes, fichiers, cas, etc., s'affichent. Ces identifiants peuvent être utiles lors de la rédaction de requêtes SQL.
9
10
10
-
Checking the Show IDs box displays the numeric IDs for codes files cases and more. These IDs may be useful when writing sql queries.
11
+
Quelques options permettent de modifier l'apparence générale de QualCoder.
11
12
12
-
There area few options to change the overall look of QualCoder.
13
+
Pour la transcription audio et vidéo, le format de temps et le type de crochets peuvent être sélectionnés.
13
14
14
-
For transcribing audio and video, the time format and bracket type can be selected.
15
-
16
-
Very large text files can slow the coding mode in QualCoder. So a right-click option in Code Text is to load smaller sized chunks of the text. 50,000 characters is the default size, but this can be changed in Settings to smaller sizes for slower computers.
15
+
Les fichiers texte très volumineux peuvent ralentir le mode de codage dans QualCoder. Une option de clic droit dans **Coder le texte** permet de charger des portions plus petites du texte. La taille par défaut est de 50 000 caractères, mais celle-ci peut être réduite dans les paramètres pour les ordinateurs plus lents.
Project backup can be set to automatically backup every hour, or no backup. QualCoder keeping the most recent backups with a date and hour time stamp. The backup name is: _projectname_BKP_yyyymmdd_hh.qda_ Where _hh_ is 24 hour time. This also means multiple backups are not done within an hour. So a new backup cannot overwrite another backup created within the same hour. A limited number of backups are kept, **older backups are deleted**. Setting option allows you to choose from 1 to 10 backups.
23
-
24
-
I recommend that you make a backup before doing any substantial changes, such as reorganising codes and categories, merging projects, or merging codes. QualCoder does perform hourly backups (keeping up to the most recent five) if backups are set in the settings.
25
-
26
-
Rename or move to another location particular backups that you need to keep. When the backups are set, an additional option is to choose to backup the audio/video files. For completeness of backups it is recommended to back up audio and video, however this may slow down opening of the software if you have many large files. Alternatively you can link to large audio/video files rather than import them into the project folder. The default project directory is where many file operations will default to, for export or looking to import files.
27
-
28
-
In your home folder QualCoder will create a .qualcoder folder with a QualCoder.log file for logging events and a config.ini file which will contain a lot of settings such as the current coder’s name, preferred fonts, language and a preferred working directory. Do not sure any data or project inside the .qualcoder folder. The only file that you should put in here is a stopwords.txt file, only if you need to apply a different set of stopwords for word cloud and word count functions. This folder is only for the QualCoder software to use as it is running.
29
-
30
-
## Advanced options and logging
31
-
32
-
The **AI related options** at the bottom of the Settings dialog are described here: [AI Setup](https://github.com/ccbogel/QualCoder/wiki/2.3.-AI-Setup)
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
19
+
### Sauvegardes
42
20
21
+
La sauvegarde du projet peut être configurée pour s'effectuer automatiquement toutes les heures, ou pas du tout. QualCoder conserve les sauvegardes les plus récentes avec un horodatage de date et d'heure. Le nom de la sauvegarde est : _nomduprojet_BKP_aaaammjj_hh.qda_, où _hh_ correspond à l'heure en format 24 heures. Cela signifie également qu'aucune sauvegarde supplémentaire n'est effectuée dans la même heure. Un nombre limité de sauvegardes est conservé, **les sauvegardes les plus anciennes sont supprimées**. L'option de paramétrage permet de choisir entre 1 et 10 sauvegardes.
43
22
23
+
Il est recommandé de faire une sauvegarde avant d'effectuer des modifications importantes, comme la réorganisation des codes et des catégories, la fusion de projets ou de codes. QualCoder effectue des sauvegardes horaires (en conservant jusqu'à cinq sauvegardes récentes) si cette option est activée dans les paramètres.
44
24
25
+
Renommez ou déplacez vers un autre emplacement les sauvegardes spécifiques que vous souhaitez conserver. Lorsque les sauvegardes sont activées, une option supplémentaire permet de choisir de sauvegarder également les fichiers audio/vidéo. Pour des sauvegardes complètes, il est recommandé de sauvegarder les fichiers audio et vidéo, bien que cela puisse ralentir l'ouverture du logiciel si vous avez de nombreux fichiers volumineux. Alternativement, vous pouvez lier les fichiers audio/vidéo volumineux plutôt que de les importer dans le dossier du projet. Le répertoire par défaut du projet est celui vers lequel de nombreuses opérations de fichiers pointeront par défaut, pour l'export ou l'import de fichiers.
45
26
27
+
Dans votre dossier personnel, QualCoder créera un dossier `.qualcoder` contenant un fichier `QualCoder.log` pour enregistrer les événements et un fichier `config.ini` qui contiendra de nombreux paramètres, tels que le nom du codeur actuel, les polices préférées, la langue et un répertoire de travail préféré. Ne stockez aucune donnée ou projet dans le dossier `.qualcoder`. Le seul fichier que vous pouvez y placer est un fichier `stopwords.txt`, uniquement si vous souhaitez appliquer un ensemble différent de mots vides pour les fonctions de nuage de mots et de comptage de mots. Ce dossier est réservé à l'usage interne de QualCoder pendant son exécution.
46
28
29
+
## Options avancées et journalisation
47
30
31
+
Les **options liées à l'IA**, situées en bas de la boîte de dialogue des paramètres, sont décrites ici : [Configuration de l'IA](https://github.com/ccbogel/QualCoder/wiki/2.3.-AI-Setup)
0 commit comments