Difference between revisions of "MythGallery"
(Copy Readme from SVN and wikify. Changed the last part to reflect current best practice. Left as Stub as article can still be expanded.) |
(Add sql on settings) |
||
(30 intermediate revisions by 17 users not shown) | |||
Line 1: | Line 1: | ||
− | { | + | {{outdated}} |
− | + | ||
− | + | This based on the README file for MythGallery. | |
− | + | ||
+ | The '''MythGallery''' plug-in allows you to view all your photos as well as short movies from your digital camera. Myth Gallery will show your photos as they are organised in your file system. Myth will generate thumbnails of both folders as well as individual photos. Many new digital cameras can now take high quality movies typically in [[MPEG-4]] format as well as photos. Mythgallery can show these as well, provided that you have the video player setting set up to play that media type. | ||
+ | |||
==Build/Configuration Instructions== | ==Build/Configuration Instructions== | ||
+ | If you have installed MythTV using a [[package manager]] then simply install the MythGallery package. Otherwise follow these instructions to compile and install the plugin. | ||
===Requirements=== | ===Requirements=== | ||
− | # | + | #At the very least, you need MythTV's database stuff setup properly. If you don't have that done, don't even bother with this, as it won't work. |
− | + | ||
===Compiling=== | ===Compiling=== | ||
− | + | In the main distribution directory configure the package by typing | |
− | + | <pre>./configure</pre> | |
− | + | ||
− | + | You can enable OpenGL support using | |
+ | <pre>./configure --enable-opengl</pre> | ||
+ | Make sure you have OpenGL support for your graphics card available and enabled if you choose this option. You can check this under X11 using <tt>xdpyinfo</tt> or <tt>glxinfo</tt>. Also ensure that QT has been built with OpenGL support) | ||
+ | |||
+ | You can also enable [[EXIF]] support using | ||
+ | <pre>./configure --enable-exif</pre> | ||
+ | This requires you have the libexif headers/libraries installed and in your include/lib path when compiling. An install of the libexif/libexif-devel packages from your favorite package repository usually provides this. Currently, [[EXIF]] support only consists of auto-rotating images if the camera sets the orientation tag (My Canon S400 does). | ||
+ | |||
+ | Next do | ||
+ | <pre> | ||
+ | $ make | ||
+ | </pre> | ||
+ | |||
+ | |||
+ | Follow this by a | ||
+ | <pre># make install</pre> | ||
+ | which puts the <tt>libmythgallery.so</tt> plugin in the <tt>/usr/local/lib/mythtv/plugins</tt> directory. | ||
+ | |||
+ | MythGallery will also read the <tt>mysql.txt</tt> settings files used by MythTV, so any changes you made to those will be carried over into this. | ||
+ | |||
===Configuration=== | ===Configuration=== | ||
− | After compiling and installing, you will need to enter the setup menu from [[mythfrontend]] to configure mythgallery. | + | After compiling and installing, you will need to enter the setup menu from [[mythfrontend]] to configure mythgallery. Setup/Media Settings/Images Settings. Change the directory parameter to where you're storing your pictures. |
+ | |||
+ | Note that the default storage location is on the local machine, not necessarily the backend. If you have frontends where you want to load images from a remote machine you will need to setup a [[Mediashares]], or use an nfs mount. | ||
+ | |||
+ | The full list of settings is | ||
+ | |||
+ | Page 1 (General) | ||
+ | |||
+ | * Directory that holds images | ||
+ | * y/n Store thumbnails in image directory | ||
+ | * Sort order when browsing | ||
+ | * Paths to import images from | ||
+ | * y/n Automatically load MythGallery to display pictures | ||
+ | * Directory filter | ||
+ | * Type filter | ||
+ | |||
+ | Page 2 (Slideshow) | ||
+ | |||
+ | * y/n Use OpenGL transitions | ||
+ | * Slideshow Delay | ||
+ | * y/n Recuse into directories | ||
+ | * Overlay caption | ||
+ | * Type of transition | ||
+ | * Type of background | ||
+ | |||
+ | You can access the raw settings in phpmyadmin with | ||
+ | |||
+ | * SELECT * FROM `settings` where value like 'Gallery%' | ||
==Usage== | ==Usage== | ||
− | This should be really simple to use -- | + | Its a good idea to organise the top level screen as a collection of folders only. You can have subfolders within folders also. |
+ | |||
+ | This should be really simple to use -- You select the folder you want by using the [[Image:RemoteUp.png]] [[Image:RemoteDown.png]] [[Image:RemoteRight.png]] [[Image:RemoteLeft.png]]. | ||
+ | |||
+ | Press [[Image:RemoteSelect.png]] to view photos within the desired directory.You will then see the individual photos themselves. | ||
+ | |||
+ | Press [[Image:RemoteSelect.png]] to view just that photo. | ||
+ | |||
+ | Press [[Image:RemoteInfo.png]] to get information on that photo. | ||
+ | |||
+ | While viewing photos you can use the [[Image:RemoteUp.png]] [[Image:RemoteDown.png]] buttons to jump forwards and backwards between photos. | ||
+ | |||
+ | Press [[Image:RemoteExit.png]] to exit photo viewing. | ||
+ | |||
+ | Pressing 'p' while viewing a single image or while an image icon is highlighted will start a slide show playback of all images in that directory. Image rotation can be done by pressing the [ and ] keys. | ||
+ | |||
+ | Press [[Image:RemoteMenu.png]] to highlight the On Screen Menu. | ||
+ | |||
+ | The [[Image:RemoteUp.png]] [[Image:RemoteDown.png]] buttons will move up and down the On Screen Menu. | ||
+ | |||
+ | The Settings Option brings up the Myth Gallery Settings screen where you can change the slide show transition parameters. Check the use OpenGL transitions and you can now choose some of the funky transitions available. | ||
===Default Keys=== | ===Default Keys=== | ||
− | |||
====Thumbnail View Keys==== | ====Thumbnail View Keys==== | ||
{|border=1 cellspacing=1 cellpadding=5 | {|border=1 cellspacing=1 cellpadding=5 | ||
+ | |''Remote Command'' | ||
|''Key'' | |''Key'' | ||
|''Function'' | |''Function'' | ||
|- | |- | ||
+ | |[[Image:RemoteMenu.png]] Menu | ||
|M | |M | ||
|Toggle the menu | |Toggle the menu | ||
|- | |- | ||
+ | |[[Image:RemotePause.png]] Pause | ||
|P | |P | ||
− | |Start SlideShow | + | |Start/Stop SlideShow |
+ | |- | ||
+ | | | ||
+ | |D | ||
+ | |Delete image | ||
|- | |- | ||
+ | | [[Image:RemoteStart.png]] Start | ||
|Home | |Home | ||
|Go to the first image in thumbnail view | |Go to the first image in thumbnail view | ||
|- | |- | ||
+ | || [[Image:RemoteEnd.png]] End | ||
|End | |End | ||
|Go to the last image in thumbnail view | |Go to the last image in thumbnail view | ||
|- | |- | ||
+ | |[[Image:RemoteSelect.png]] Select | ||
|Enter/SpaceBar | |Enter/SpaceBar | ||
|Open a Directory/View an image | |Open a Directory/View an image | ||
|- | |- | ||
− | |Left | + | |[[Image:RemoteLeft.png]] Left Cursor |
+ | |Left Arrow | ||
+ | |Navigate through images/directories | ||
+ | |- | ||
+ | |[[Image:RemoteRight.png]] Right Cursor | ||
+ | |Right Arrow | ||
+ | |Navigate through images/directories | ||
+ | |- | ||
+ | |[[Image:RemoteUp.png]] Up Cursor | ||
+ | |Up Arrow | ||
+ | |Navigate through images/directories | ||
+ | |- | ||
+ | |[[Image:RemoteDown.png]] Down Cursor | ||
+ | |Down Arrow | ||
|Navigate through images/directories | |Navigate through images/directories | ||
+ | |- | ||
|} | |} | ||
====Image View Keys==== | ====Image View Keys==== | ||
{|border=1 cellspacing=1 cellpadding=5 | {|border=1 cellspacing=1 cellpadding=5 | ||
+ | |''Remote Command'' | ||
|''Key'' | |''Key'' | ||
|''Function'' | |''Function'' | ||
|- | |- | ||
+ | |[[Image:RemotePause.png]] Pause | ||
|P | |P | ||
|Start/Stop SlideShow | |Start/Stop SlideShow | ||
|- | |- | ||
+ | | | ||
+ | |D | ||
+ | |Delete image | ||
+ | |- | ||
+ | |[[Image:330.png]] 3 | ||
|],3 | |],3 | ||
|Rotate image right 90 degrees | |Rotate image right 90 degrees | ||
|- | |- | ||
+ | |[[Image:130.png]] 1 | ||
|[,1 | |[,1 | ||
|Rotate image left 90 degrees | |Rotate image left 90 degrees | ||
|- | |- | ||
+ | |[[Image:730.png]] 7 | ||
|7 | |7 | ||
|Zoom out of image | |Zoom out of image | ||
|- | |- | ||
+ | |[[Image:930.png]] 9 | ||
|9 | |9 | ||
|Zoom into image | |Zoom into image | ||
|- | |- | ||
+ | |[[Image:230.png]] 2 | ||
|2 | |2 | ||
|Scroll image up | |Scroll image up | ||
|- | |- | ||
+ | |[[Image:430.png]] 4 | ||
|4 | |4 | ||
|Scroll image left | |Scroll image left | ||
|- | |- | ||
+ | |[[Image:630.png]] 6 | ||
|6 | |6 | ||
|Scroll image right | |Scroll image right | ||
|- | |- | ||
+ | |[[Image:830.png]] 8 | ||
|8 | |8 | ||
|Scroll image down | |Scroll image down | ||
|- | |- | ||
+ | |[[Image:530.png]] 5 | ||
|5 | |5 | ||
|Recenter image | |Recenter image | ||
|- | |- | ||
+ | |[[Image:030.png]] 0 | ||
|0 | |0 | ||
|Full-size (un-zoom) image | |Full-size (un-zoom) image | ||
|- | |- | ||
+ | |[[Image:RemoteREW.png]] Rewind | ||
|PageUp | |PageUp | ||
|Go to the upper-left corner of the image | |Go to the upper-left corner of the image | ||
|- | |- | ||
+ | |[[Image:RemoteFF.png]] Fast Forward | ||
|PageDn | |PageDn | ||
|Go to the lower-right corner of the image | |Go to the lower-right corner of the image | ||
|- | |- | ||
+ | |[[Image:RemoteInfo.png]]Info | ||
|I | |I | ||
|Toggle Showing Information about Image | |Toggle Showing Information about Image | ||
Line 95: | Line 206: | ||
When <tt>import</tt> is pressed in the menu each item in the import directory search path will be examined. If the item is a directory, its contents will be recursively copied to a new directory whose name is the current date and time. Using this method, removable devices can be put in the search path if they use an automount system (see the Linux documentation for info on how to use automount systems). If the item is an executable file, it will be executed with 1 argument consisting of the name of the new subdirectory. This way, import from a removable device can be accomplished without the use of an automount system. | When <tt>import</tt> is pressed in the menu each item in the import directory search path will be examined. If the item is a directory, its contents will be recursively copied to a new directory whose name is the current date and time. Using this method, removable devices can be put in the search path if they use an automount system (see the Linux documentation for info on how to use automount systems). If the item is an executable file, it will be executed with 1 argument consisting of the name of the new subdirectory. This way, import from a removable device can be accomplished without the use of an automount system. | ||
− | == | + | ==Screenshots== |
− | + | <gallery> | |
+ | Image:GalleryMain.jpg|Top Level | ||
+ | Image:GalleryPics.jpg|Gallery Directory | ||
+ | Image:GalleryTransition.jpg|OpenGl Transition | ||
+ | Image:GalleryInfo.jpg|Picture Info | ||
+ | </gallery> | ||
+ | ==Troubleshooting== | ||
+ | 1) Slideshow stops after x number of slides (on frontend). | ||
+ | |||
+ | Solution 1: disable / uninstall gnome-screensaver (try this if slideshow works when frontend started with sudo) | ||
− | [[Category: | + | Solution 2: If above does not work, this has been reported to work sometimes: disable DPMS |
+ | [[Category:Plugins]] | ||
{{stub}} | {{stub}} |
Latest revision as of 05:27, 11 January 2014
Outdated: The information on this page may no longer be relevant to the current release of MythTV, 34.0. Please consider helping to update it. This page was last modified on 2014-01-11.
This based on the README file for MythGallery.
The MythGallery plug-in allows you to view all your photos as well as short movies from your digital camera. Myth Gallery will show your photos as they are organised in your file system. Myth will generate thumbnails of both folders as well as individual photos. Many new digital cameras can now take high quality movies typically in MPEG-4 format as well as photos. Mythgallery can show these as well, provided that you have the video player setting set up to play that media type.
Contents
Build/Configuration Instructions
If you have installed MythTV using a package manager then simply install the MythGallery package. Otherwise follow these instructions to compile and install the plugin.
Requirements
- At the very least, you need MythTV's database stuff setup properly. If you don't have that done, don't even bother with this, as it won't work.
Compiling
In the main distribution directory configure the package by typing
./configure
You can enable OpenGL support using
./configure --enable-opengl
Make sure you have OpenGL support for your graphics card available and enabled if you choose this option. You can check this under X11 using xdpyinfo or glxinfo. Also ensure that QT has been built with OpenGL support)
You can also enable EXIF support using
./configure --enable-exif
This requires you have the libexif headers/libraries installed and in your include/lib path when compiling. An install of the libexif/libexif-devel packages from your favorite package repository usually provides this. Currently, EXIF support only consists of auto-rotating images if the camera sets the orientation tag (My Canon S400 does).
Next do
$ make
Follow this by a
# make install
which puts the libmythgallery.so plugin in the /usr/local/lib/mythtv/plugins directory.
MythGallery will also read the mysql.txt settings files used by MythTV, so any changes you made to those will be carried over into this.
Configuration
After compiling and installing, you will need to enter the setup menu from mythfrontend to configure mythgallery. Setup/Media Settings/Images Settings. Change the directory parameter to where you're storing your pictures.
Note that the default storage location is on the local machine, not necessarily the backend. If you have frontends where you want to load images from a remote machine you will need to setup a Mediashares, or use an nfs mount.
The full list of settings is
Page 1 (General)
* Directory that holds images * y/n Store thumbnails in image directory * Sort order when browsing * Paths to import images from * y/n Automatically load MythGallery to display pictures * Directory filter * Type filter
Page 2 (Slideshow)
* y/n Use OpenGL transitions * Slideshow Delay * y/n Recuse into directories * Overlay caption * Type of transition * Type of background
You can access the raw settings in phpmyadmin with
* SELECT * FROM `settings` where value like 'Gallery%'
Usage
Its a good idea to organise the top level screen as a collection of folders only. You can have subfolders within folders also.
This should be really simple to use -- You select the folder you want by using the .
Press to view photos within the desired directory.You will then see the individual photos themselves.
Press to view just that photo.
Press to get information on that photo.
While viewing photos you can use the buttons to jump forwards and backwards between photos.
Pressing 'p' while viewing a single image or while an image icon is highlighted will start a slide show playback of all images in that directory. Image rotation can be done by pressing the [ and ] keys.
Press to highlight the On Screen Menu.
The buttons will move up and down the On Screen Menu.
The Settings Option brings up the Myth Gallery Settings screen where you can change the slide show transition parameters. Check the use OpenGL transitions and you can now choose some of the funky transitions available.
Default Keys
Thumbnail View Keys
Image View Keys
Importing Pictures
When import is pressed in the menu each item in the import directory search path will be examined. If the item is a directory, its contents will be recursively copied to a new directory whose name is the current date and time. Using this method, removable devices can be put in the search path if they use an automount system (see the Linux documentation for info on how to use automount systems). If the item is an executable file, it will be executed with 1 argument consisting of the name of the new subdirectory. This way, import from a removable device can be accomplished without the use of an automount system.
Screenshots
Troubleshooting
1) Slideshow stops after x number of slides (on frontend).
Solution 1: disable / uninstall gnome-screensaver (try this if slideshow works when frontend started with sudo)
Solution 2: If above does not work, this has been reported to work sometimes: disable DPMS