view README @ 3:fd9ff64a1fe9

README: added instruction to make a logical AND with filters
author Goffi <goffi@goffi.org>
date Thu, 22 Jul 2010 21:28:29 +0800
parents 6f4b5e24cf08
children a8b144574340
line wrap: on
line source

lm v0.1.1
(c) Jérôme Poisson aka Goffi 2010

lm is of software to list movies, loosely inspired from ls.



** LICENSE **

lm is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

lm is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with lm.  If not, see <http://www.gnu.org/licenses/>.



** WTF ? **

lm list media files (only movies so far), getting information on IMDb, allowing you to display sexy titles (instead of often unreadable filename), sort by rating, display plot, etc.



** How to use it ? **

lm --help

each time you launch lm, it gets metadata for files it doesn't know, which is really slow. So, be sure to try on a directory with a few movies to test it.

** Filters **

you can filter your query using the --filter argument (or the short -f)
Currently, you can filter on genre, director or actor.
The syntax is --filter @keyword:filter,filter,filter@keyword2:filter,filter
e.g.:
lm --filter "@director:tim burton@genre:drama,fantasy"

filters are case insensitive

filter user logical OR (it means that lm --filter "@genre:sci-fi,comedy" will return all science-fiction movies and all comedies ("Starship Troopers" and "Le dîner de cons" are accepted by this filter).
If you want to use a logical AND, you can use two time the filter: lm --f@genre:sci-fi@genre:comedy will return all science-fiction movies which are also comedies (like "Galaxy Quest").


** Credit **

Internet Movie Database (IMDb) is one of the oldest site on Internet, and, as its name says, give a lot of informations on movies

IMDbPY:
lm use IMDbPY to get information on IMDb (http://imdbpy.sourceforge.net/), many thanks to its authors



** See also **

You can also have a look on my other projets:
- SàT: a XMMP client in heavy development, my main project at the moment
- mkvconvert: a small script to convert mkv files unreadable with vlc to mkv with xvid



** Contact **

You can contact me on goffi@goffi.org
You'll find the latest version on my website: http://www.goffi.org (it's mainly in french, I will probably make a little part in english in the future).