RECOLL.CONF(5) File Formats Manual RECOLL.CONF(5) (NAME) recoll.conf - Recoll (DESCRIPTION) Recoll . /usr/[local]/share/recoll/examples . : $HOME/.recoll/recoll.conf (override) . recoll -c $RECOLL_CONFDIR . : # Space-separated list of directories to index. topdirs = ~/docs /usr/share/doc [~/somedirectory-with-utf8-txt-files] defaultcharset = utf-8 : o () . o . o (Section). # . 'name = value' . . : 'fn': 'dfn': . . . . (~) . 'string' . . (OPTIONS) topdirs = string . (symbolic links) followLinks . ~ : . monitordirs = string . (real-time) . 'topdirs' . skippedNames = string . ( '/' ) . . "local parameters" (GUI) . ( ) . Thunderbird . ".*" "skippedNames" "~/.thunderbird" "~/.evolution" "topdirs" . "noContentSuffixes" . . skippedNames- = string skippedNames. . skippedNames+ = string skippedNames. . onlyNames = string . . skippedNames . . . noContentSuffixes = string ( ) ("Ignored endings" ). . recoll_noindex mimemap ( mimemap recoll.conf ). skippedNames ( ) . . noContentSuffixes- = string noContentSuffixes. noContentSuffixes+ = string noContentSuffixes. skippedPaths = string . ( ). . topdirs . /home /usr/home topdirs "~" "/home/yourlogin" . skippedPaths "/home/yourlogin" ** "/usr/home/yourlogin". . "fnmatch(3)" FNM_PATHNAME . "/" . "skippedPathsFnmPathname" 0 FNM_PATHNAME ( "/*/dir3" "/dir1/dir2/dir3" ). Recoll . "/media/xxx" "topdirs" . skippedPathsFnmPathname = bool FNM_PATHNAME 0 . nowalkfn = string . skippedPaths . : .recoll-noindex daemSkippedPaths = string skippedPaths . . daemSkippedPaths skippedPaths . followLinks = bool . . . "topdirs" . "topdirs" . "topdirs" . indexedmimetypes = string MIME . ( ). . indexallfilenames () . MIME mimemap ( xdg-mime file -i ). . Recoll 1.43.7 ( ) . excludedmimetypes = string MIME . . MIME mimemap ( xdg-mime file -i ). . Recoll 1.43.7 ( ) . nomd5types = string MIME md5 . md5 . md5 . ( ). (exec execm) . MIME ( audio/mpeg) ( rclaudio.py) . compressedfilemaxkbs = int . . . . 0 . 100 . zip rar ** gzipped . textfilemaxmbs = int . (log) . . 20 . -1 . textfilepagekbs = int . text/plain . . . textfilemaxmbs compressedfilemaxkbs . textunknownasplain = bool text/xxx text/plain. "file" "xdg-mime" text/whatever . ( ) text/plain . indexallfilenames = bool . MIME . usesystemfilecommand = bool MIME . 'file' 'xdg-mime' MIME . Recoll libmagic . libmagic . "" . zip ( libreoffice) application/zip . "systemfilecommand" . disablelibmagic = bool libmagic. libmagic usesystemfilecommand . . systemfilecommand = string MIME ( libmagic ). libmagic . "file --mime-type" . . "xdg-mime" "file" ( "file"). processwebqueue = bool . Recoll . membermaxkbs = int . RECOLL_FILTER_MAXMEMBERKB MIME . indexStripChars = bool (diacritics) . . (stripped) . . . indexStoreDocText = bool . (snippets) . Xapian . Xapian Chert 1.2 1.4 1.6 . UTF-8 . . xapiandb . Xapian . Xapian 1.4 0 Chert . 1 Glass . : . . Xapian 1.4 0 / API recollq . nonumbers = bool (terms) . nonumbers "123" "1.5e6" 192.168.1.4 ( "value123" ). nonumbers . . notermpositions = bool . . . dehyphenate = bool "co-worker" "coworker" . 1.22 . . indexedpunctuation = string UTF-8 . "%EUR" ( ) "100%" "100EUR" . "100%" "100 %" . backslashasletter = bool . TeX . underscoreasletter = bool (underscore) . . maxtermlength = int . . 40 . . maxdbdatarecordkbs = int Xapian. "" . . Xapian 100 . maxdbstoredtextmbs = int . Xapian 100 . nocjk = bool / ( - CJK). CJK CPU . nocjk . cjkngramlen = int n-gram CJK . 2 . 3 . hangultagger = string . n-gram. https://www.recoll.org/pages/recoll-korean.html . chinesetagger = string . Jieba n-gram. https://www.recoll.org/pages/recoll-chinese.html . indexstemminglanguages = string (stemming) . "recollindex -l" . english french... defaultcharset = string () . ( text/plain). "charset" HTML . NLS ($LC_ALL, $LC_CTYPE, $LANG) iso-8859-1 ( cp-1252). LANG 8859-1 . . unac_except_trans = string UTF-8 . a a . . / . . ( ) ASCII "" . : Swedish: unac_except_trans = aa Aa oo Oo uu Uu ssss oeoe OEoe aeae AEae ffff fifi flfl aa Aa '' ' ' -- - German: unac_except_trans = aa Aa oo Oo uu Uu ssss oeoe OEoe aeae AEae ffff fifi flfl '' ' ' -- - French: you probably want to decompose oe and ae and nobody would type a German ss unac_except_trans = ssss oeoe OEoe aeae AEae ffff fifi flfl '' ' ' -- - . unac . unac_except_trans = ssss oeoe OEoe aeae AEae ffff fifi flfl '' ' ' -- maildefcharset = string . readpst (libpst) utf-8 . localfields = string ( ). : name = value ; attr1 = val1 ; [...] - . rclaptg mimeview . testmodifusemtime = bool mtime ctime . . ( ) ctime . : - ( mtime ). - noxattrfields 1 xattr ( ). . noxattrfields = bool (extended attributes) . testmodifusemtime . metadatacmds = string tmsu. - . - . . "field" . "rclmulti" recoll ( "fieldname = fieldvalue") . rclmultixx . : metadatacmds = ; tags = tmsu tags %f; rclmulti1 = cmdOutputsConf %f cachedir = dfn Recoll. Recoll ( ~/.recoll/xapiandb ~/.recoll/mboxcache). "cachedir" ( cachedir ~/.cache/recoll dbdir ~/.cache/recoll/xapiandb ). dbdir webcachedir mboxcachedir aspellDicDir cachedir . cachedir cachedir . maxfsoccuppc = int . "Capacity" df . 0 . . dbdir = dfn Xapian. . cachedir ( -c $RECOLL_CONFDIR) . ~/.recoll/xapiandb/ . idxstatusfile = fn . : idxstatus.txt . mboxcachedir = dfn mbox. "mboxcache" cachedir . mboxcacheminmbs = int mbox . . 5 . mboxmaxmsgmbs = int mbox . mbox . webcachedir = dfn . . webdownloadsdir webcachedir . : cachedir/webcache cachedir $RECOLL_CONFDIR/webcache webcachemaxmbs = int . . : 40 . . webqueuedir = fn . ~/.recollweb/ToIndex WebExtensions Downloads webqueuedir . . webdownloadsdir = fn . . webqueuedir webcachedir . webcachekeepinterval = string . URL . ("day" "week" "month" "year") . . aspellDicDir = dfn Aspell. aspell ( aspdict.(lang).rws) cachedir . filtersdir = dfn . RECOLL_FILTERSDIR . $prefix/share/recoll/filters . . iconsdir = dfn . . $prefix/share/recoll/images . idxflushmb = int ( ) (flush) . . 0 Xapian $XAPIAN_FLUSH_THRESHOLD : Xapian Recoll 0 . ( ) 100 . 10 20 300 . . filtermaxseconds = int : . 1200 (20 ). 0 . (loop.ps) . filtermaxmbytes = int : (setrlimit(RLIMIT_AS)) . ( ) . 2000 32 . (pdftk) pdftk rclpdf.py. . oomadj = int : (OOM killer) . choom(1) . adjust choom . thrQSizes = string (threading). ( ). ( ). . . 0 Recoll . ( ): 1 -> . 4 : (2, 2) (2, 2) (2, 1). 6 : (2, 4) (2, 2) (2, 1). : (2, 5) (2, 3) (2, 1). -1 . . thrTCounts = string . thrQSizes 0 -1 ( ) . 1 Xapian ( mutex ). thrTmpDbCnt = int . . . Xapian . . . suspendonbattery = bool . (AC) . loglevel = int (log) 1 6. 2 . 3 4 6 . logfilename = fn . "stderr" () . logthedate = bool . : 2025-08-21T18:58:24+0200 :3:... idxloglevel = int loglevel . idxlogfilename = fn logfilename . idxlogthedate = bool logthedate . helperlogfilename = fn . recoll[index] . /dev/null . daemloglevel = int loglevel . idx... log... . daemlogfilename = fn logfilename . idx... log... . daemlogthedate = bool logthedate . pyloglevel = int loglevel . pylogfilename = fn logfilename . pylogthedate = bool logthedate . idxnoautopurge = bool . recollindex . orgidxconfdir = dfn . . ( ) . curidxconfdir = dfn . orgidxconfdir . / . . "/home/me/mydata/config" "/media/me/mydata" orgidxconfdir "/home/me/mydata/config" curidxconfdir ( ) "/media/me/mydata/config" . idxrundir = dfn . recollindex (chdir). . ( ) tmp (RECOLL_TMPDIR TMPDIR /tmp) . . checkneedretryindexscript = fn () . /usr/bin /usr/local/bin . PATH . . recollhelperpath = string . recoll.app ( launchd PATH ). ":" ";" . idxabsmlen = int . Recoll . "abstract" . . idxabsmlen . 250 . . . idxmetastoredlen = int . ( ) . 150 . idxtexttruncatelen = int . . . idxsynonyms = fn . (: applejack "apple jack"). . idxniceprio = int "nice" . : 19 (). 1.26.5 . 19 . noaspell = bool aspell. aspell aspell aspell . aspellLanguage = string aspell. aspell . "aspell dicts" . NLS . ( "en" "fr"...). aspellAddCreateParam = string aspell. aspell ( Debian Jessie: --local-data-dir=/usr/lib/aspell). 772415 . aspellKeepStderr = bool aspell . . monauxinterval = int . (stemdb aspell) . . monixinterval = int () . . 30 . mondelaypatterns = string . . . wildcardPattern:seconds. fnmatch(pattern, path, 0) . ( ). . : mondelaypatterns = *.log:20 "*with spaces.*:30" monioniceclass = int ionice . /. 3 ( "Idle"). monioniceclassdata = string ionice . "Idle" . sofficecmd = string soffice ( libreoffice). (Apple pages) openoffice . ( C:/Program Files/) ** () . recoll PATH . idxlocalguisettings = bool (GUI) . . . preferStoredTextMimes = string MIME . ( ) . MIME . autodiacsens = bool ( / stripped). ( unac_except_trans ) . "D" . no . autocasesens = bool ( / stripped). (indexStripChars ) / . "C" . yes . maxTermExpand = int ( ). . ( 1000 ) . 10000. maxXapianClauses = int Xapian . . . 50000. snippetMaxPosWalk = int (snippet) . 1,000,000 . thumbnailercmd = string (thumbnails). . : URL MIME (SIZE 128) (PATH). . MIME : ffmpegthumbnailer -iURL -oPATH -sSIZE. stemexpandphrases = bool . Recoll . . "l" . autoSpellRarityThreshold = int . ( ) . autoSpellSelectionThreshold = int . . kioshowsubdocs = bool dolphin/kio krunner KDE. kio krunner . . pdfocr = bool OCR PDF . . (off) OCR . pdfforceocr = bool OCR PDF . . OCR PDF . pdfoutline = bool PDF ( pdftohtml ). . pdfattach = bool PDF pdfdetach ( ). pdftk . pdfdetach poppler-utils . pdfextrameta = string XMP . XMP . Recoll "|" . Recoll . "fields" . pdfextrametafix = fn XMP. XMP . "MetaFixer" ()metafix . . zipUseSkippedNames = bool skippedNames Zip. rclzip.py . skippedNames Zip . . https://www.recoll.org/faqsandhowtos/FilteringOutZipArchiveMembers.html . zipSkippedNames = string zip . zip . zipUseSkippedNames zipSkippedNames . zipUseSkippedNames . . https://www.recoll.org/faqsandhowtos/FilteringOutZipArchiveMembers.html . zipMetaEncoding = string . 3.11+ . chardet "detect" . zip UTF-8 ( ) CP437 () . . "detect" 3 "chardet" . orgmodesubdocs = bool 1 org-mode . . false org-mode . mhmboxquirks = string mbox thunderbird/mozilla- seamonkey. () mbox . imgocr = bool OCR. OCR PDF PDF . OCR mimeconf . . imgocr . ocrprogs = string OCR . OCR OCR . tesseract (tesseract) ABBYY FineReader (abbyy) . "tesseract" . . . ocrcachedir = dfn OCR. OCR $RECOLL_CONFDIR/ocrcache . tesseractlang = string OCR tesseract. OCR . . rclocrtesseract.py . : eng, fra... tesseract . '+' eng+fra. . tesseractcmd = fn tesseract. . tesseract . : tesseractcmd = C:/ProgramFiles/Tesseract-OCR/tesseract.exe abbyylang = string OCR abbyy. OCR . . rclocrabbyy.py . : English, French... ABBYY . abbyyocrcmd = fn abbyy. ABBY PATH . speechtotext = string . "whisper" whisper OpenAI . sttmodel = string whisper. sttdevice = string (device) whisper. (SEE ALSO) recollindex(1) recoll(1) 14 November 2012 RECOLL.CONF(5)