1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
What is this?
=============
Tumbler is a D-Bus service for applications to request thumbnails for
various URI schemes and MIME types. It is an implementation of the
thumbnail management D-Bus specification described on
http://live.gnome.org/ThumbnailerSpec
written in an object-oriented fashion using GLib and GObject. Its
modular architecture makes it very flexible and useful in many
situations. It provides plugin interfaces for extending the URI schemes
and MIME types for which thumbnails can be generated as well as
for replacing the storage backend that is used to store the thumbnails
on disk. Tumbler's functionality can also be extended via specialized
thumbnailer services implemented in accordance to the thumbnail
management D-Bus specification.
Required packages
=================
Tumbler depends on the following packages:
* glib-2.0 >= 2.16.0
* gio-2.0 >= 2.16.0
* gthread-2.0 >= 2.16.0
* dbus-1 >= 1.0.0
* dbus-glib-1 >= 0.72
Tumbler can optionally use the following packages:
* gdk-pixbuf-2.0 >= 2.14.0 (for a pixbuf thumbnailer plugin)
* FreeType 2.x (for a font thumbnailer plugin)
* libpng >= 1.2.0 (for the Thumbnail Managing Standard storage
backend, gdk-pixbuf-2.0 is also required for this)
Installation
============
The 'INSTALL' file contains generic installation instructions.
Debugging Support
=================
Tumbler currently supports four different levels of debugging support,
which can be setup using the configure flag `--enable-debug' (check the
output of `configure --help'):
`full' Use this if you want to debug Tumbler to locate a bug. The
build will most probably be noticably slower. This is also
recommended for people that want to develop Tumbler stuff.
`yes' This is the default for git snapshot builds. It adds all
kinds of checks to the code, and is therefore likely to run
slower. Use this if you want to develop for Tumbler (e.g.
writing Tumbler extensions and such).
`minimum' This is the default for release builds, and presents the
recommended behaviour.
`no' Disables all sanity checks. Don't use this unless you know
exactly what you do.
Standards compliance
====================
Tumbler supports and implements the following standards/specifications:
* XDG Base Directory Specification
http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
* Thumbnail Managing Standard
http://jens.triq.net/thumbnail-spec/
* Thumbnail Management D-Bus Specification
http://live.gnome.org/ThumbnailerSpec
* File URI Specification
http://www.freedesktop.org/wiki/Specifications/file-uri-spec
How to report bugs?
===================
Bugs should be reported to the Xfce bug tracking system
(http://bugzilla.xfce.org, product Tumbler). You will need to
create a bugzilla account for yourself first.
Please read the HACKING file for informaiton on where to send
changes or bugfixes for this package.
|
