Index: README =================================================================== --- README (revision 2285) +++ README (working copy) @@ -12,7 +12,9 @@ Table of Contents 5.1 Notes on Solaris 5.2 Compile Options 6 Running Tracker - 6.1 Setting Inotify Watch Limit + 6.1 Usage + 6.2 Setting Inotify Watch Limit + 6.3 Tracker files 7 Tracker & Nautilus Search 8 Tracker & Deskbar applet 9 Tracker tools @@ -117,6 +119,8 @@ Table of Contents * Provides option to disable indexing when running on battery. + * Provides option to index removable devices. + * Implements the freedesktop specification for metadata (http://freedesktop.org/wiki/Standards/shared-filemetadata-spec). @@ -177,8 +181,13 @@ Table of Contents * unac (accent stripper) * exempi * libxml2 + * libxml2 (for extracting html/xml content) + * hal 0.5 (for detection of removable devices, mounted + directories, as well as whether the computer is running on + battery) + 4.3 For building Tracker's Deskbar-applet backend * python-dev 2.3 @@ -278,7 +287,12 @@ Table of Contents --enable-external-qdbm : use system qdbm instead of one included in Tracker - --disable-hal : disables HAL support for ac-power detection + --disable-hal : disables HAL support, which is for detecting + whether the computer is running on battery (for EG, determining + whether to run the indexer in such a case), whether a removable + device has been attached (for EG, determining whether to index + its contents), and for detecting mounted directories (for EG, + determining whether to index such) --disable-trackerapplet : disables Tracker's notification applet @@ -286,8 +300,10 @@ Table of Contents 6 Running Tracker - To run Tracker, you need to manually start the Tracker daemon, - trackerd. By default trackerd will index your entire home +6.1 Usage + + To run Tracker, you need to manually start the Tracker daemon, + trackerd. By default trackerd will index your entire home directory. You can also pass a directory root to be indexed as a command @@ -337,9 +353,9 @@ Table of Contents "WatchDirectoryRoots=directory1;directory2;directory3"" - An additional option is the "--reindex" option which indexes - user data from scratch, removing the need to remove Tracker - database manually. + An additional option is "--reindex" which indexes user data from + scratch, removing the need to delete Tracker's database manually. + Keywords and metadata definitions are preserved however. On the first run, Tracker will automatically create a new database and start populating it with metadata by browsing @@ -355,7 +371,7 @@ Table of Contents tracker-search SEARCHTERM) -6.1 Setting Inotify Watch Limit +6.2 Setting Inotify Watch Limit When watching large numbers of folders, its ppossible to exceed the default number of inotify watches. In order to get real time @@ -370,7 +386,24 @@ Table of Contents "sudo /etc/init.d/procps restart" +6.3 Tracker files + Here is some of the files that Tracker uses during its operation, + apart from "~/.config/tracker" which is stated above, in Sec 6.1: + + * "~/.local/share/tracker" is used for non-expendable content, + like keywords and metadata definitions. + + * "~/.cache/tracker" is used for the expendable indexes and + expendable metadata that can be rebuilt if deleted (this is the + purpose of the ".cache" - its more a permanent tmp directory than + sys tmp but can be deleted if more disk space is needed). + + * The system tmp ("/var/tmp" and "/tmp") is used for short-lived + session data. + + + 7 Tracker & Nautilus Search Once you have installed Tracker and have some indexed contents, Index: TODO =================================================================== --- TODO (revision 2285) +++ TODO (working copy) @@ -1,11 +1,96 @@ -* support for ignoring diacritics in search (version 0.6.1) -* support for Thunderbird 2 after it's released -* .desktop file indexing -* chat logs +general: +* XESAM integration +* indexer backend independence (not just rely on SQLite) +* automatic language detection +* DocBook indexing +* manpage indexing + +application support: +* Balsa mboxes +* Brasero integration +* Epiphany integration (bookmarks and history) * Rhythmbox integration * Tomboy notes indexing -* Epiphany integration -* Brasero integration -* manpage indexing -* DocBook indexing + +search: * search filtering (EG search within specific folders) +* search results that update in real time +* search within archives +* "exact phrase" search +* wildcard search + +needing GLib 2.16: +* addition of unit tests +* (maybe) drop in-lined xdgmime +* (maybe) drop in-house file monitoring + + +the following were copied from Tracker SoC project ideas: + +1. HAL integration into Tracker + + * We need to be able to handle files in removable media + * Database already includes support for removable volumes and all file + services have an enable flag which can be used for this + * Needs to be able to auto-index files when a usb drive is plugged in + * Needs to be able to update URIs for all affected files when a usb drive + is mounted (paths of a previously indexed mount might be different when + remounted) + * Need to be able to hide files and exclude from search when a usb drive is + unmounted + +2. Linux kernel watchless file notification system for Tracker + + * currently we are using inotify which is not optimal for watching entire + trees. (OSX has kernel file notifications by contrast) + * Implement a loadable module for the kernel which allows all file activity + to be passed to userspace Tracker + * Ideally should make use of netlink + * Allow tracker to connect and receive these events. + * implement file notification handler for it in tracker + +3. Extend the GTK Tracker Widget Library + + * Include a generic search result widget + o A reusable widget which can show results from tracker + o widget should allow paging of results via scrolling instead of + buttons (downloading of all search results in one go is not allowed + so it needs to be smart) + o Widget should be able to seamlessly switch into multiple views + (icon, list, compact list) + o Add special view when all results are exclusively Music based. + View should show a sorted list of music metadata album, artist etc + (similar to rhythmbox music view) + o widget should offer basic file management including drag and drop, + deletes, renames via popup menu + o widget should allow watermarking of background (use cairo) with a + definable pixmap + o widget should allow an optional popup preview when moused over for + a few seconds (kind of like knoqueror does) + * RDF Query widget + o mockup: http://bugzilla.gnome.org/attachment.cgi?id=80132&action=view + o The Rhythmbox automatic playlist may also serve useful as inspiration + +4. Better KDE Integration + + * Improve basic GUI with corresponding features from the GNOME GUI + (tags, metadata tile, thumbnails) + * add ability to index KContacts and KNotes + +5. Add XMP Sidecar and IPTC support to tracker + + * implement an XMP compatible parser (using glib xml parser) + * backup all user defined metadata into XMP sidecar format + * allow indexing of sidecar files when indexing a file so users can edit + these files to add metadata + * extract IPTC metadata embedded into images + * see GNOME bug #401664 + +6. Networked Tracker + + * Use avahi/dbus to locate remote tracker servers. Could make use of ssh + or as suggested use gabriel. + * Api would need to be added to add support for retrieving list of servers + * TST would need to be changed to list all available servers to use and + allow user to pick one + * If using DBus over ssh then could use seahorse for ssh key pairing Index: data/modules/files.module =================================================================== --- data/modules/files.module (revision 2285) +++ data/modules/files.module (working copy) @@ -8,7 +8,7 @@ RecurseDirectories= [Ignored] Directories=po;CVS;.svn;.git -Files=*~*;*.o;*.la;*.lo;*.loT;*.in;*.csproj;*.m4;*.rej;*.gmo;*.orig;*.pc;*.omf;*.aux;*.tmp;*.po;*.vmdk;*.vm*;*.nvram;*.part;autom4te;conftest;confstat;Makefile;SCCS;litmain.sh;libtool;config.status;confdefs.h; +Files=*~;*.o;*.la;*.lo;*.loT;*.in;*.csproj;*.m4;*.rej;*.gmo;*.orig;*.pc;*.omf;*.aux;*.tmp;*.po;*.vmdk;*.vm*;*.nvram;*.part;autom4te;conftest;confstat;Makefile;SCCS;litmain.sh;libtool;config.status;confdefs.h; [Index] Service= Index: NEWS =================================================================== --- NEWS (revision 2285) +++ NEWS (working copy) @@ -1,3 +1,25 @@ +Tracker 0.6.90 +============= (whenever) + + Major refactoring work + * cleaner code, some things moved to libaries. + * Refactored DBus interface: Now with introspection! (The method names don't + change, but the objects do, so the client applications must be updated) + * New DB access code (libtracker-db library). + * New binary, tracker-indexer, created so to separate indexing functionality + away from the daemon. + + Miscellaneous + * Added support for indexing removable media. + * Added support for the mobile email client, Modest. This adds to Evolution, + Thunderbird, and KMail, among supported clients. + * Added support for OR search operations. + * Initial xesam support. + * Addition of unit tests. + * In-house file monitoring dropped in favour of GLib's GIO. + * New functionality to estimate remaining indexing time period. + + Tracker 0.6.6 ============= (03 Mar 2008)