Installing DocFetcher

Write tutorials here
There are more tutorials here http://community.linuxmint.com/tutorial/welcome
Forum rules
Please don't add support questions to tutorials,start your own thread in the appropriate sub-forum instead. Before you post please read this
Cosmo.
Level 21
Level 21
Posts: 14229
Joined: Sat Dec 06, 2014 7:34 am

Installing DocFetcher

Postby Cosmo. » Wed Nov 30, 2016 7:02 pm

The tutorial has been updated to reflect a change in version 1.1.18.

DocFetcher is a program for indexing the content of files in various formats, besides others Libre (Open) Office and PDF files. Installing it needs a little bit hand work, as described here.
Note: Linux is case-sensitive. You have to obey this, if you use the terminal commands, which follow.

Download from here the portable version and store it somewhere inside of your home; now unpack it. You will get a new folder named like DocFetcher-x.y.z, where x,y and z represent the version number. For ease of use rename this folder to DocFetcher. Now open a terminal and go into this folder; assumed, that you had stored the downloaded file into the folder Downloads in your home, you have to enter in the terminal cd ~/Downloads/DocFetcher.

There are 2 program-starters for Linux inside: DocFetcher-GTK2.sh and DocFetcher-GTK3.sh. Lastly both do the same, but on some systems only one of both works. Simply try it to find this out. On Linux Mint 17.x with Cinnamon both do the job; in this case take the second command.
To start DocFetcher for the first time with one of the previously given commands. On the first run it might take some seconds, until the program opens, because at the first run some files get stored in the subfolder lib, which are dependent from the used operating system (Linux in this case); this process works automatically.

Next open (for ease of use with your graphical file manager) the subfolder misc and open the file paths.txt in your file manager. You find a line starting with #settings= and another one starting with #indexes=; the # means, that those lines are commented out and ore only for reference. Insert a new line below both of them, the first one with the line:

Code: Select all

settings=${user.home}/.docfetcher/conf

the other one with the line:

Code: Select all

indexes=${user.home}/.docfetcher

Those lines define the places, where settings and indexes will get stored. Don't replace anything, but enter (or copy / paste) them as given here.
Save the file and close it.

Now you have as root to copy the complete folder DocFetcher inside of the folder /opt. In case, that /opt is missing on your system, you can create it as root. With this step every user account on the system will be able to use the program.

For easier access create now symbolic links for the files DocFetcher-GTK2.sh or DocFetcher-GTK3.sh (depending from what you found to be working on your system) and docfetcher-daemon-linux into the folder /usr/bin; this has to be done as root. Rename the first link file (in /usr/bin) to docfetcher (= replace the capital letters and remove the GTK-version and the ending). Now you can start the programs without the need to enter the complete pathname from the terminal.

To set DocFetcher into the menu use the terminal and enter the command

Code: Select all

gnome-desktop-item-edit --create-new DocFetcher.desktop
In the upcoming dialog enter as name DocFetcher and as command docfetcher. An appropriate icon can be found in the folder /opt/DocFetcher/img. If finished move this file as root into /usr/share/applications.

DocFetcher is now functioning.

To get the daemon working there are some more steps to do. If you have a 64 bit system you must have the package ia32-libs installed; this is already installed by default in Mint 17.x and Mint 18. Before you can use the daemon you must have at first at least set one folder in DocFetcher for monitoring. If you miss this you will encounter, that the daemon will occupy one cpu-core with 100 %. (Besides that without anything to monitor the daemon does not make any sense.) The daemon gets started with the command line docfetcher-daemon-linux.

You might want to run the daemon automatically after booting the system. Simply add a command for the autostart programs in your account with the command line docfetcher-daemon-linux.


This has been tested with Linux Mint 17.x Cinnamon 64 bit.
As usual: If there are open questions, create a new thread in the software section of the forum.

Return to “Tutorials”

Who is online

Users browsing this forum: No registered users and 6 guests