gryf/pygtktalog
1
0
Fork 0
mirror of https://github.com/gryf/pygtktalog.git synced 2025-12-17 19:40:21 +01:00
Code Issues Projects Releases Wiki Activity

Updated readme

Browse Source
This commit is contained in:
Roman Dobosz
2016-08-21 15:56:28 +02:00
parent 9799e4b75f
commit 422fdf0d58
2 changed files with 36 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
README.rst
View File

@@ -2,10 +2,9 @@ pyGTKtalog 1.0
============== ==============
pyGTKtalog is Linux/FreeBSD program for indexing CD/DVD or directories on pyGTKtalog is Linux/FreeBSD program for indexing CD/DVD or directories on
filesystem. It is similar to gtktalog <http://www.nongnu.org/gtktalog/> or filesystem. It is similar to `gtktalog`_ or `gwhere`_ . There is no coincidence
gwhere <http://www.gwhere.org/home.php3>. There is no coincidence in name of in name of application, because it's meant to be replacement (in some way) for
application, because it's meant to be replacement (in some way) for gtktalog, gtktalog, which seems to be dead project for years.
which seems to be dead project for years.
.. image:: /example/main.png .. image:: /example/main.png
:alt: pyGTKtalog main screen :alt: pyGTKtalog main screen
@@ -13,7 +12,7 @@ which seems to be dead project for years.
WARNING! WARNING!
======== ========
This version is mostly outdated, full of bugs, and may eat your data! First **This version is mostly outdated, full of bugs, and may eat your data!** First
usable version (this is what you are looking at right now) was completed around usable version (this is what you are looking at right now) was completed around
2009 year, but implementation was done much earlier. During that time GTK2 was 2009 year, but implementation was done much earlier. During that time GTK2 was
changed significantly several times, because of that couple of pyGTKtalog changed significantly several times, because of that couple of pyGTKtalog
@@ -38,9 +37,9 @@ FEATURES
* get/generate thumbnails from EXIF and other images * get/generate thumbnails from EXIF and other images
* stores selected EXIF tags * stores selected EXIF tags
* add/edit description and notes * add/edit description and notes
* fetch comments for images made in gThumb <http://gthumb.sourceforge.net> * fetch comments for images made in `gThumb`_
* add/remove unlimited images to any file or directory * add/remove unlimited images to any file or directory
* tagging files <http://en.wikipedia.org/wiki/Tag_%28metadata%29> * `tagging files`_
* and more :) * and more :)
Couple of screens showing how it looks like: Couple of screens showing how it looks like:
@@ -54,23 +53,24 @@ Couple of screens showing how it looks like:
.. image:: /example/search.png .. image:: /example/search.png
:alt: Search window and image view :alt: Search window and image view
Also, in ``example`` directory you'll find a database ``example.sqlite`` to play
with.
REQUIREMENTS REQUIREMENTS
============ ============
pyGTKtalog is written in python with following dependencies: pyGTKtalog is written in python with following dependencies:
- python 2.4 or higher * python 2.4 or higher
- pygtk 2.10 or higher <http://www.pygtk.org> * `pygtk 2.10`_ or higher
- pysqlite2 <http://pysqlite.org/> (unnecessary, if python 2.5 is used) * `pysqlite2`_ (unnecessary, if python 2.5 is used)
Optional modules: Optional modules:
- PIL <http://www.pythonware.com/products/pil/index.htm> for image * `PIL`_ for image manipulation
manipulation
Additional pyGTKtalog uses pygtkmvc <http://pygtkmvc.sourceforge.net> by Additional pyGTKtalog uses `pygtkmvc`_ by Roberto Cavada and EXIF module by Gene
Roberto Cavada and EXIF module by Gene Cash (slightly updatetd to EXIF 2.2 by Cash (slightly updatetd to EXIF 2.2 by me) which are included in sources.
me) which are included in sources.
pyGTKtalog extensively uses external programs in unix spirit, however there is pyGTKtalog extensively uses external programs in unix spirit, however there is
small possibility of using it Windows (probably with limitations) and quite small possibility of using it Windows (probably with limitations) and quite
@@ -88,11 +88,11 @@ directory to pyGTKtalog and simply run:
That's it. Alternatively, if you like to put it in more system wide place, all That's it. Alternatively, if you like to put it in more system wide place, all
you have to do is: you have to do is:
- put pyGTKtalog directory into your destination of choice (/usr/local/share, * put pyGTKtalog directory into your destination of choice (/usr/local/share,
/opt or ~/ is typical bet) /opt or ~/ is typical bet)
- copy pyGTKtalog shell script to /usr/bin, /usr/local/bin or in * copy pyGTKtalog shell script to /usr/bin, /usr/local/bin or in
other place, where PATH variable is pointing or you feel like. other place, where PATH variable is pointing or you feel like.
- then modify pyGTKtalog line 6 to match right pygtktalog.py directory * then modify pyGTKtalog line 6 to match right ``pygtktalog.py`` directory
Then, just run pyGTKtalog script. Then, just run pyGTKtalog script.
@@ -164,3 +164,12 @@ LICENSE
This work is licensed under the terms of the GNU GPL, version 3. See the LICENCE This work is licensed under the terms of the GNU GPL, version 3. See the LICENCE
file in top-level directory. file in top-level directory.
.. _gtktalog: http://www.nongnu.org/gtktalog/
.. _gwhere: http://www.gwhere.org/home.php3
.. _PIL: http://www.pythonware.com/products/pil/index.htm
.. _pygtk 2.10: http://www.pygtk.org
.. _pysqlite2: http://pysqlite.org/
.. _pygtkmvc: http://pygtkmvc.sourceforge.net
.. _gThumb: http://gthumb.sourceforge.net
.. _tagging files: http://en.wikipedia.org/wiki/Tag_%28metadata%29

9
example/README.rst Normal file
View File

@@ -0,0 +1,9 @@
Example
=======
Here you can find example database and some screen shots made using this db.
All materials used to prepare sample database and the screen shots were
downloaded from freely available resources from pages:
http://www.hd-trailers.net/ and http://www.imdb.com - all rights goes to
appropriate parties.