top Introduction
libvalhalla is a library written in C. It is a media scanner, that stores various information in an SQLite database and relies on FFmpeg (libavformat and libavutil) and libcurl. It features many Internet grabbers that allows automatic download of covers, lyrics, informations on media files, tags retrival in video and music files and so on.
It is a free software - it is licensed under the terms of the GNU Lesser General Public License (GNU/LGPL) version 2.1+.
top Latest News
libvalhalla is work in progress right now. If you're interested in its development, you're highly welcomed to join in.
Current stable release is 2.1.0, featuring with the following changes :
- Minor improvements.
- Fix for Amazon grabber
- Fix for TheMovieDB (TMDB) grabber
- Bug fixes.
- ... Look at ChangeLog
Supported grabbers :
- Allocine
- Amazon
-
EXIF
relies on libexif -
FFmpeg
relies on libavcodec - ImDB
- Last.fm
- localfiles
- ChartLyrics
- LyricWiki.org
-
NFO
relies on libnfo - TheTVDB.com
- TheMovieDB.org
- TVRage.com
Previous stable release
Changes in 2.0.0 :
- Faster shutdown on force-stop.
- Support of concurrent grabbers.
- New ChartLyrics grabber.
- Support of languages and priorities with the metadata.
- Rework of many public functions.
- Support for MS Windows and Darwin.
Changes in 1.0.1 :
- Fixes and improvements in configure/Makefiles.
- Fix some SQL queries to escape filenames with ["].
- Fix potential segfaults when a new database is opened by an older version of libvalhalla.
- Fix Allocine PHP script to handle correctly the number of results. And now, the script returns all directors.
- Fix ondemand when more than one query is sent for the same file, while that the first ondemand is not finished.
- Fix the URL for the "images" server of TheTVDB.com grabber.
- Fix the compilation for *BSD/Hurd (at least with the glibc).
- Fixes in the LyricWiki grabber in order to prevent that HTML tags appear in the result instead of the lyrics.
Changes in 1.0.0 :
- Initial project release
- Full scanning, parsing and grabbing support
top Copyright and License
libvalhalla is copyright (C) 2009-2010 Mathieu Schroeter, Benjamin Zores.
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
This library 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 Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; If not, see <http://www.gnu.org/licenses/>.
top Documentation
More documentation will be provided in some time.
You can find the public API documentation
HTML
/
PDF
automatically generated from the libvalhalla source code, using
Doxygen.
top Download
The currently available libvalhalla release is 2.1.0.
Sources can be downloaded
here.
Development Tree
The latest libvalhalla development tree can be grabbed using Git, a revision control system, similar in purpose to tools such as CVS, SCCS, SVN and Arch. It is used to keep track of the changes made to a source tree and to help programmers combine and otherwise manipulate changes made by multiple people or at different times.
There are currently 2 ways of accessing the Git tree : via command-line or (to just have a look to some changes on a specific file, for example) You can directly access to the web interface with your browser from :
In order to access to Git via command line, create and enter a new
directory and do the following (be sure that you have installed the
git package).
-
To get a local copy of the libvalhalla repository :
git clone https://github.com/GeeXboX/libvalhalla.git
-
To update your local copy, synchronizing with our server :
git pull
topFeedback
The author of libvalhalla and this document, Mathieu Schroeter, can be contacted by e-mail.
Please send bug reports, suggestions, ideas, comments or patches to the GeeXboX devel mailing list : devel@geexbox.org