| Plugin |
|
Description |
|
captions/db/digikam
Kevin Barter
|
|
Get the image caption from the Digikam description.
.. (expand)
Options:
-digikam:db REQUIRED Location of the digikam3.db file. If this
file is at /home/user/digikam3.db, then use
-digikam:db /home/user/digikam3.db
-digikam:usetags OPTIONAL Value can be X or nothing. If set to X,
the caption will contain the description of the
photo, as well as all of the tags for the photo
(collapse)
|
|
captions/exif/exiftool
David Ljung Madison
|
|
Alternate method of getting exif info using exiftool,
can also read IPTC metadata
.. (expand)
Uses: Image::ExifTool package (not in CPAN)
See: http://www.sno.phy.queensu.ca/~phil/exiftool/
This is useful for Windows users that may have problems with jhead.
(collapse)
|
|
captions/exif/gps
Andreas K Huettel
|
|
Enables ouput of formatted GPS data in captions, e.g. google maps links.
Options: none
|
|
captions/exif/mouseover
David Madison
|
|
Add a mouseover window to images that displays photo EXIF info.
|
|
captions/exif/strftime
Steven Schubiger
|
|
Reformat EXIF date/time with strftime() format string.
|
|
captions/format/audio
Scott J. Bertin
|
|
Adds audio to image pages.
.. (expand)
If you have an image named pict1234.jpg (for example), this plugin will
find pict1234.wav and allow it to be played on the image page. It will
look for audio files in wav, aiff, au, and mid format.
(collapse)
|
|
captions/format/hide_shorten
David Ljung Madison
|
|
Caption shortener
.. (expand)
Shortens captions with a '..' link that reveals the hidden caption.
You can change the option length with: -hide_shorten:length
(collapse)
|
|
captions/format/no_dash
David Ljung Madison
|
|
Converts dashes '-' to spaces ' ' for names.
Only converts names based on files (as opposed to captions)
Avoids converting dates "<num>-<num>"
|
|
captions/format/video_tag
David Ljung Madison
|
|
Video tagger
.. (expand)
Adds tags to video captions like: '[Video, 26M]'
You can change whether size is shown with the option -video_tag:size
(collapse)
|
|
captions/paypal/simple
David Ljung Madison
|
|
Paypal linker.
Adds simple paypal links to each image.
.. (expand)
You need to set the email with the -paypal_email <email> option.
You can also set a default price with the -paypal_price <price> option,
or else specify a price in the beginning of each caption, such as:
sunset.jpg Beautiful Sunset .50 Here is the caption
(collapse)
|
|
dir_thumbs/captions
David Madison
|
|
Pick directory thumbnail based on captions.txt file.
.. (expand)
In captions.txt you can add a "caption" line:
dir_thumb <file>
Where <file> is the image you want to use to select the directory thumbnail.
You can also specify a directory (relative paths only), in that case we'll
recursively look there for the thumbnail, using album dir_thumb behavior
(or possibly this plugin again)
Based on ideas from Dave Hansen <http://www.sr71.net/>
(collapse)
|
|
dir_thumbs/file
Joey Richards
|
|
Specify an image for the directory thumbnail.
|
|
extra/piclens
Reidar D. Midtun
|
|
Generates a Media RSS feed containing the album images. If the medium option is used,
an additional media stream containing the medium resolution images is made.
A link to the PicLens plugin and a link to launch a slide show using the PicLens plugin
is added to the album header.
|
|
extra/rss
Jason Dufair
|
|
Generates an rss feed for recently added/updated albums and images
|
|
extra/rss2
Igor S. Livshits
|
|
Generates RSS 2.0 feeds for recently added or changed items in albums
|
|
format/favicon
David Ljung Madison
|
|
Plugin: format/favicon
.. (expand)
Adds favicon tags to the <head> section of album pages.
You need to specify your favicon url:
% album -favicon:url "//DavePics.com/Icons/favicon.jpg"
Would add this to head:
<link rel="SHORTCUT ICON" href="//DavePics.com/Icons/favicon.jpg" />
(collapse)
|
|
format/google_analytics
David Ljung Madison
|
|
Plugin: format/google_analytics
.. (expand)
Adds Google Analytics (Universal Analytics) tags to the <head> section of album pages.
Uses the latest version of the tracking id.
Please note that Universal Analytics has been obsoleted and replaced
with GA4 Google Analytics, which is very similar, but requires a new
analytics property with a G-XXXX tag instead of the UA-XXX tag.
To use a G-XXXX tag, you want the format/google_analytics4 plugin
See: http://google.com/analytics/
You need to specify your tracking id to the plugin with something like:
% album -google_analytics:id UA-XXXXXXX-X
The tracking id can be found embedded in the tracking code that
google gives you, probably on a line that looks like this:
var pageTracker = _gat._getTracker("UA-XXXXXXX-X");
It's the part inside the quotes that the plugin needs.
According to google: "Where can I find my tracking code?"
https://www.google.com/support/googleanalytics/bin/answer.py?answer=55603
1. Sign in to Google Analytics
2. From the Analytics Settings page, find the profile for which you
would like to retrieve the tracking code. Please note that tracking
code is profile-specific.
3. From that profile's Settings column, click Edit
4. At the top right of the Main Website Profile Information box,
click Check Status
5. Your tracking code can be found in the text box in
the Instructions for adding tracking section
Issues about tracking? Don't ask me, ask google:
https://www.google.com/support/googleanalytics/bin/answer.py?answer=75129
Google may update/change their code, in which case this plugin
will no longer work without being updated! If you find that the
code this plugin generates is out-of-date, make sure you have the
most current version of album and it's plugins from:
http://MarginalHacks.com/
And if so, please contact us and let us know!
(collapse)
|
|
format/google_analytics4
David Ljung Madison
|
|
Plugin: format/google_analytics4
.. (expand)
Adds GA4 google_analytics4 tags to the <head> section of album pages.
Uses the latest version of the tracking id.
See: http://analytics.google.com/
You need to specify your tracking id to the plugin with something like:
% album -google_analytics4:id G-XXXXXXXXXX
The tracking id can be found embedded in the tracking code that
google gives you, probably on a line that looks like this:
gtag('config', 'G-XXXXXXXXXX');
It's the part inside the quotes that the plugin needs.
According to google: "Where can I find my tracking code?"
https://www.google.com/support/googleanalytics/bin/answer.py?answer=55603
1. Sign in to Google Analytics
2. From the Analytics Settings page, find the profile for which you
would like to retrieve the tracking code. Please note that tracking
code is profile-specific.
3. From that profile's Settings column, click Edit
4. At the top right of the Main Website Profile Information box,
click Check Status
5. Your tracking code can be found in the text box in
the Instructions for adding tracking section
Issues about tracking? Don't ask me, ask google:
https://www.google.com/support/googleanalytics/bin/answer.py?answer=75129
Google may update/change their code, in which case this plugin
will no longer work without being updated! If you find that the
code this plugin generates is out-of-date, make sure you have the
most current version of album and it's plugins from:
http://MarginalHacks.com/
And if so, please contact us and let us know!
(collapse)
|
|
format/image_protect
David Ljung Madison
|
|
Plugin: format/image_protect
.. (expand)
Protects images from downloading.
No image protection scheme is foolproof!
If you publish it, and someone knows what they're doing, then
you won't be able to stop them from keeping it.
Method:
1) Disables "Image Toolbar" for image
2) Disables right clicking for image
3) Turns off link to full-size image
Also see album's "-credit" option.
(collapse)
|
|
format/meta
David Ljung Madison
|
|
Adds meta tags to the <head> section of album pages.
Thanks to Ty [tyr poczta fm] for the suggestion!
|
|
format/opengraph
David Ljung Madison
|
|
Adds opengraph tags to the <head> section of album pages.
|
|
format/opengraph
David Ljung Madison
|
|
Adds opengraph tags to the <head> section of album pages.
|
|
images/annotate-medium
David Ljung Madison
|
|
Annotates medium images with a string of text such as a copyright tag.
Copyright idea credit: Joe Botha
|
|
images/autorot
David Ljung Madison
|
|
Autorotates images based on EXIF captions.
Uses 'jhead' program, and does rotation the first time it sees the image.
Idea credit: Fridtjof Busse, who is too lazy to type jhead himself. :)
|
|
images/epeg
Scott J. Bertin
|
|
Uses enlightenment 'epeg' (or Image::Epeg if available) to scale jpegs.
.. (expand)
Only works if scaling geometry is in max size format (i.e., 640x640).
This is dramatically faster than using convert, probably around 3x.
Requires epeg version 0.9.0.004 or higher.
(collapse)
|
|
images/exactimage
Frank Breitling
|
|
Creates thumbnails via ExactImage or Image::ExactImage if available
.. (expand)
The ExactImage library was developed for speed. As such it creates thumbnails
from JPEG images about 4x faster than ImageMagick's convert which is otherwise
used by album.
This plugin was created as an alternative to the images/epeg plugin since the
epeg library was difficult to find and install on Ubuntu 11.10. A solution was
provided by ExactImage lib which was available as distribution package.
Moreover the ExactImage lib supports a variety of other formats in addition to
JPEG. For the complete list of supported formats as well as further
information about ExactImage see
http://www.exactcode.com/site/open_source/exactimage/ .
The author would like to acknowledge the 'images/epeg' plugin by Scott J.
Bertin which served as a template, the constructive communication with David
Ljung Madison which made him come up with this plugin and last but not least
the ExactImage library.
(collapse)
|
|
images/heyendael
David Ljung Madison, Simon Oosthoek
|
|
Autorotates images based on EXIF captions.
Uses 'jhead' program, and does rotation the first time it sees the image.
Idea credit: Fridtjof Busse, who is too lazy to type jhead himself. :)
.. (expand)
Significant speedup when images already exist by Simon Oosthoek.
(collapse)
|
|
images/tile-annotate
Zoltan Csala
|
|
Annotates *medium* images with a tiled string of text such as a copyright tag.
Copyright idea credit: Joe Botha
Implemented by: Zoltan Csala
|
|
images/xy_cache
David Ljung Madison
|
|
Caches the image size information in a database to speedup album generation.
Bug: The xy database never gets cleaned. If you move images or alter them,
it will just continue to grow. Remove it if it gets too big.
.. (expand)
Thanks to Johann Botha [joe frogfoot com] for the suggestion!
(collapse)
|
|
media/flv
David Madison,
Jeroen Wijering
|
|
Uses JW Player and ffmpeg to include FLV videos in albums.
.. (expand)
ffmpeg is used for making the snapshot file (tn/file.snap.flv.jpg).
Unfortunately it doesn't work on all flv files, you may have to
make the snapshot manually (it should be the same size as the video).
JW Player is released under a non-commercial license, please see:
% album -media/flv:show_license
The JW Player is copied into each album directory using symlinks
if your system supports symlinks. If; however, your web server
will not follow symlinks outside of your web tree, you can do:
% album -media/flv:no_symlink
(collapse)
|
|
media/html5player
Antoine Emerit
|
|
Uses the <video...> or <audio...> HTML tags to include videos and audios
with an embedded player in albums.
% album -media/html5player:show_license
|
|
media/videoplayer
David Madison,
Jeroen Wijering
|
|
Uses JWPlayer/Mediaplayer to include videos with an embedded player
in albums.
.. (expand)
JW Player is released under a non-commercial license, please see:
% album -media/videoplayer:show_license
The JW Player is copied into each album directory using symlinks
if your system supports symlinks. If; however, your web server
will not follow symlinks outside of your web tree, you can do:
% album -media/videoplayer:no_symlink
(collapse)
|
|
org/hide_regex
David Hansen
|
|
Hide any albums that match a regex.
|
|
org/link
Matt Forrest
|
|
If the image is a link, use a link for the medium and thumbnail.
The image must be in an album readable by the webserver
(or have a 'tn/' directory)
|
|
org/reorganizer
Scott J. Bertin
|
|
Have images stored in one place appear in albums elsewhere.
.. (expand)
For the most basic usage, reorganizer will recursively copy the contents of
the specified source directory to the directory being processed by album.
It will copy images, captions, and thumbnails. Normally, this copying will
be done using hard links to reduce disk usage.
If any images have a .albums file (for example image.jpg and image.albums),
that file will be read and interpreted as a list of additional directories
(relative to the album directory) where the image should appear.
If the reorganizer:albums_only option is set, the recursive copy will be
skipped, and only .albums files will be consulted for where the images should
end up.
If the reorganizer:no_copy_images option is used, the images will be accessed
from the original location with no duplication. In this case, an image in
multiple albums will only have the thumbnail generated once (unless the
reorganizer:no_common_thumbnails option is used).
It is mandatory to supply at least one source, or reorganizer will not do
anything.
If a source directory (or subdirectory) contains a .hide_album file, it will
not be duplicated, but it will still be processed for .albums files.
If a source directory (or subdirectory) contains a .no_album file, it will
not be processed at all.
The destination directory must exist before running album.
Images with a .no_img or .hide_album file will be ignored even if there is
a .albums file for that image.
No files will be overwritten unless the -force option is used.
This plugin uses many hooks, and modifies album's internal data structures.
Not all hooks are used for their intended purpose, so it should be loaded
as the first plugin if possible.
(collapse)
|
|
org/specified_sort
Scott J. Bertin
|
|
Sort pics/dirs as specified in a file (default "album.order").
.. (expand)
The file can list names or directives to override some or all
of the normal album sorting.
Unknown names are sorted in the default album order.
The following special 'names' are recognized:
[:NOREVERSE:] Ignores the reverse_sort option for the current file.
[:UNKNOWN:] Placeholder for unknown values, overrides the
unknowns_first option.
[:DIRSONLY:] Only sort directories, not pics.
[:PICSONLY:] Only sort pics, not directories.
If both [:DIRSONLY:] and [:PICSONLY:] both appear in the file, no
special sorting is done.
The file is only checked for exact matches, patterns are not used. This is
intentional so that the order is unambiguous.
If an item appears twice in the file, the order of that item will depend on
the first occurence that is found when the search is made. This creates
interesting possibilities for ordering with and without the reverse_sort
option. If you put an item both first and last in the file, it will appear
first regardless of the reverse_sort option, assuming no unknowns, or an
[:UNKNOWNS:] line between the 2 occurrences.
(collapse)
|
|
social/facebook-comments
David Ljung Madison
|
|
Plugin: social/facebook-comments
.. (expand)
Include facebook comments on images/albums using FB comment plugin:
https://developers.facebook.com/docs/plugins/comments/
Evidently there isn't any way to get notified on FB if anyone leaves
comments on your album, but you can specify a user or app_id to be a
moderator, and then you can go to the moderation tool to see them:
https://developers.facebook.com/tools/comments?view=queue
If anyone knows how to create comment boxes that have automatic
subscribers, please let me know! (Though I can see how FB would
be worried that someone would use this for spamming).
Facebook may update/change their code, in which case this plugin
will no longer work without being updated! If you find that the
code this plugin generates is out-of-date, make sure you have the
most current version of album and it's plugins from:
http://MarginalHacks.com/
And if so, please contact us and let us know!
This plugin requires the use of the 'format/opengraph' plugin
(collapse)
|
|
social/facebook-like
David Ljung Madison
|
|
Plugin: social/facebook-like
.. (expand)
Add facebook like/share buttons!
https://developers.facebook.com/docs/plugins/like-button
Facebook may update/change their code, in which case this plugin
will no longer work without being updated! If you find that the
code this plugin generates is out-of-date, make sure you have the
most current version of album and it's plugins from:
http://MarginalHacks.com/
And if so, please contact us and let us know!
This plugin requires the use of the 'format/opengraph' plugin
(collapse)
|
|
social/flattr
Volker Sauer
|
|
Plugin: social/flattr
.. (expand)
Adds flattr tags to the <head> section of album pages
and a flattr-Button below your picture.
For details on flattr see: http://flattr.com
You need to specify your flattr-URL.
The flattr-URL can be found embedded in the HTML-code that
flattr gives you, probably on a line that looks like this:
<a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="http://this.is.my-flattr.url"></a>
It's the href-part inside the <a> tag. Probably it is the url of your site!
Flattr may update/change their code, in which case this plugin
will no longer work without being updated! If you find that the
code this plugin generates is out-of-date, make sure you have the
most current version of album and it's plugins from:
http://MarginalHacks.com/
And if so, please contact us and let us know!
Volker Sauer
http://www.volker-sauer.de/
(collapse)
|
|
utils/capindex
David Ljung Madison
|
|
Creates an HTML captioned index of all the photos in a hierarchy of albums.
|
|
utils/create_plugin
David Ljung Madison
|
|
Create a new plugin framework by answering a few simple questions
|
|
utils/keynavigation
Matti Laitala
|
|
Adds left, right and up arrow key navigation to easy usability while browsing
thumbnailed album. Left arrow goes to previous image and right arrow to
next image. Arrow up navigates one level up.
.. (expand)
Plugin utilizes jQuery from google server,
see https://developers.google.com/speed/libraries/devguide for more information.
Tested: Firefox, Chrome
Author: Matti Laitala
Modifications: David Ljung Madison
(collapse)
|
|
utils/mv
David Ljung Madison
|
|
This will move images from one album to another.
It also moves associated files (thumbnails, medium) and updates captions.txt
.. (expand)
It will rebuild the albums if you specify '-gen' in the options.
You can use a special shorthand to call this plugin:
% album -mv <images..> <destination>
You can view usage with:
% album -mv -h
(collapse)
|
