App-sitelenmute

 view release on metacpan or  search on metacpan

README.md  view on Meta::CPAN


# SYNOPSIS

**sitelen-mute** \[**OPTION** ...\] _SOURCE_ _DIRECTORY_

# DESCRIPTION

**Sitelen Mute** is a static photo gallery generator. It takes all the images it
can find in the source directory and writes a static gallery to the output
directory: scaled images, zipped originals, thumbnails, Javascript code for
navigation, and an HTML file. You can upload this to a simple web server.

**-h**, **--help** shows this help.

**-v** increases the verbosity. Repeat for more detail.

**-s** produces "slim" output: no original files or album to download. The
default is to create a zip file with all the originals in it. Creating a zip
files requires the `zip` or `7za` (7-Zip).

**-i** include originals as individual files. The default is to create a just a

README.md  view on Meta::CPAN

**-p** prevents the inclusion of full-sized panoramas.

**-n** _NAME_ sets the album name, i.e. the title in the browser window.

**--index** _URL_ is the location for the index/back button.

The following three options add meta tags for previews on social media. They
must all three be specified, if at all.

**--url** _URL_ is the eventual URL of the gallery. That is, you need to know
where you're uploading the gallery to.

**--title** _TITLE_ is the title for previews on social media.

**--description** _DESCRIPTION_ is the (longer) description to use for the
preview on social media.

**-f** improves thumbnails by using face detection. This requires `facedet`.

**--noblur** skips the generation of blurry backdrops and simply uses dark noise
instead.

README.md  view on Meta::CPAN


    python -m SimpleHTTPServer 8000

This serves all the files from `http://localhost:8000`.

## convert: width or height exceeds limit

An error message containing "convert-im6.q16: width or height exceeds limit" is
a sign that your ImageMagick installation has a security policy that prevents
"image bombs" – images that are so large that they could bomb your server if you
is using ImageMagick to process images uploaded from the Internet. If you a
_sure_ that you are not using ImageMagick in this way, here's a way to disable
this security policy.

You can show the limits using `identify -list resource`:

    Resource limits:
      Width: 16KP
      Height: 16KP
      List length: 18.446744EP
      Area: 128MP

README.md  view on Meta::CPAN

`/etc/ImageMagick-6/policy.xml` and make the following change:

    62c62
    <   <policy domain="resource" name="width" value="16KP"/>
    ---
    >   <policy domain="resource" name="width" value="32KP"/>

# FEATURES

There is no server-side processing, only static generation. The resulting
gallery can be uploaded anywhere without additional requirements and works with
any modern browser.

- Automatically orients pictures without quality loss.
- Multi-camera friendly: automatically sorts pictures by time: just throw
  your (and your friends) photos and movies in a directory. The resulting
  gallery shows the pictures in seamless shooting order.
- Adapts to the current screen size and proportions, switching from
  horizontal/vertical layout and scaling thumbnails automatically.
- Supports face detection for improved thumbnail centring.
- Loads fast! Especially over slow connections.

script/sitelen-mute  view on Meta::CPAN


=head1 SYNOPSIS

B<sitelen-mute> [B<OPTION> ...] I<SOURCE> I<DIRECTORY>

=head1 DESCRIPTION

B<Sitelen Mute> is a static photo gallery generator. It takes all the images it
can find in the source directory and writes a static gallery to the output
directory: scaled images, zipped originals, thumbnails, Javascript code for
navigation, and an HTML file. You can upload this to a simple web server.

B<-h>, B<--help> shows this help.

B<-v> increases the verbosity. Repeat for more detail.

B<-s> produces "slim" output: no original files or album to download. The
default is to create a zip file with all the originals in it. Creating a zip
files requires the C<zip> or C<7za> (7-Zip).

B<-i> include originals as individual files. The default is to create a just a

script/sitelen-mute  view on Meta::CPAN

B<-p> prevents the inclusion of full-sized panoramas.

B<-n> I<NAME> sets the album name, i.e. the title in the browser window.

B<--index> I<URL> is the location for the index/back button.

The following three options add meta tags for previews on social media. They
must all three be specified, if at all.

B<--url> I<URL> is the eventual URL of the gallery. That is, you need to know
where you're uploading the gallery to.

B<--title> I<TITLE> is the title for previews on social media.

B<--description> I<DESCRIPTION> is the (longer) description to use for the
preview on social media.

B<-f> improves thumbnails by using face detection. This requires C<facedet>.

B<--noblur> skips the generation of blurry backdrops and simply uses dark noise
instead.

script/sitelen-mute  view on Meta::CPAN


    python -m SimpleHTTPServer 8000

This serves all the files from C<http://localhost:8000>.

=head2 convert: width or height exceeds limit

An error message containing "convert-im6.q16: width or height exceeds limit" is
a sign that your ImageMagick installation has a security policy that prevents
"image bombs" – images that are so large that they could bomb your server if you
is using ImageMagick to process images uploaded from the Internet. If you a
I<sure> that you are not using ImageMagick in this way, here's a way to disable
this security policy.

You can show the limits using C<identify -list resource>:

    Resource limits:
      Width: 16KP
      Height: 16KP
      List length: 18.446744EP
      Area: 128MP

script/sitelen-mute  view on Meta::CPAN

F</etc/ImageMagick-6/policy.xml> and make the following change:

    62c62
    <   <policy domain="resource" name="width" value="16KP"/>
    ---
    >   <policy domain="resource" name="width" value="32KP"/>

=head1 FEATURES

There is no server-side processing, only static generation. The resulting
gallery can be uploaded anywhere without additional requirements and works with
any modern browser.

=over

=item Automatically orients pictures without quality loss.

=item Multi-camera friendly: automatically sorts pictures by time: just throw
  your (and your friends) photos and movies in a directory. The resulting
  gallery shows the pictures in seamless shooting order.



( run in 2.784 seconds using v1.01-cache-2.11-cpan-b16cb0d3907 )