| I believe in filenames. There, I said it. I think we badly underutilize them as a reliable way to encode document metadata. Yes, we could move the filesystem into a database, or store all sorts of metadata in one (actually, I did the latter a couple of years ago). But we could also just devise simple tools which would help us make better use of filenames. This is my goal with oyepa. If you find this terribly limiting (or otherwise unpleasant), take a look at the following related projects which adopt different approaches: Berndtsson Stefan's lafs, Peter Szabo's movemetafs, Stephen Hahn's tag and Tx0's Tagsistant. (If I missed your own project, let me know!) |
This is the homepage of oyepa. oyepa is a system which watches specific dirs for newly created documents and prompts you to tag them. You can then run queries on your document collection using a GUI document browser/locator.
Yes, it looks like an accounting app for Win3.11! But it works pretty well. : )
I am aware that you don't need this code to insert 'tags' in your filenames and then run searches on them. If you are happier using 'find', stick with it! Actually, this project started out as a simple wrapper around that same command. : ) My goal is to provide an alternative interface to achieve the same effect.
oyepa was written by Manuel Arriaga and is available as free software: it is distributed under the terms of the GPL v2.
Version 3.0 can be downloaded from here. <== DOWNLOAD FROM HERE
To become the fourth (!) oyepa user on the planet you'll need:
If you wish to be automatically prompted to tag new documents the moment you create them, you will also need to have installed:
Version 3.0 released! Added code generously contributed by Tigor Csogor that provides support for recursively watching all dirs underneath a given dir on which you are running oyepa. To achieve that, just append finish the dir name (in the file ~/.oyepa-dirs) with '/*'. When oyepa finds that suffix at the end of a dir name, it will watch both that dir as well as all directories underneath it.
Version 2.9 released! The code in oyepa-filemon.py has been updated so that it works with the most recent releases of pyinotify (>=0.8).
Version 2.8 released! A new configuration option, DONT_QUIT_INSTEAD_RUN_CMD, allows you to configure which action is triggered by the "leave" button (in search mode). This is neat when you are using oyepa as a music jukebox and want the "Leave" button not to close the application but instead to hibernate the machine (using, as I do, the excellent Tux On Ice).
Version 2.7 released!
- Fixed a bug in the install script (new file cfg.py wasn't getting installed).
- Fixed a bug in the new MusicExtensionsWidget (part of the support for jukebox functionality), in which the getExtensions() method was returning a string as a list of chars rather than as a one-item list of strings.
- Added a check to the music player (mp.py) so that the user cannot accidentally start multiple instances at the same time.
Version 2.6 released! This exciting release adds full support for document types which are actually directories on-disk (eg, you can define a ".album" document type and assign an app to open any directory whose name ends in ".album"). Also, many previously hard-coded options have been made configurable (just tweak them in the file cfg.py).
Finally, a tiny wrapper around the excellent MPlayer has been added as an optional helper to run a oyepa-based (i.e., metadata-in-the-filepaths) jukebox. It works great, and everything you need to run it is oyepa and the awesome MPlayer.
Version 2.5 released! Fixed a bug which made it impossible to rename tags, improved the wnote applet and made two other minor changes.
Version 2.4 released! Fixed one bug (which was preventing the document retagging/renaming feature from working) and made several "under-the-hood" improvements. Among the latter: (i) exceptions are now reported through the GUI; (ii) simplified the setup of the file monitor; and (iii) nicer shutdown procedure for the file monitor.
Version 2.3 released! GUI made friendlier through (i) the use of a status bar (replacing those obtrusive message boxes), (ii) support for deselecting a tag by double-clicking on it (without needing to access the pop-up menu) and (iii) when the user selects a doc, the default app for that document type is listed on the status bar.
Version 2.2 released! Small fix so that no defunct/zombie processes are left lying around through the continued usage of oyepa.
Version 2.1 released! Fixed a minor bug which kept the note creation applet from running if the note title contained non-ASCII characters.
Version 2.0 released! Rewritten almost from scratch, many more features (and a new, just as unpronounceable name, too!).
Version 1.1 released! Now includes a primitive GUI document locator.
To ask questions, offer feedback or report bugs just email me (email address found at the bottom of the page).
Manuel Arriaga - Email me at marriaga followed by @ stern . nyu . edu