sourcerer-io / anishot

Animate a long screenshot

anishot

Animates a long screenshot into a GIF. Use it to show off long screenshots in your GitHub README.

Install

$ pip install anishot

Usage

$ anishot --help
usage: anishot [-h] [--pad PAD] [--maxspeed MAXSPEED] [--stops [STOPS [STOPS ...]]]
               [--zoom-steps ZOOM_STEPS] [--start-scale START_SCALE]
               [--zoom-to ZOOM_TO] [--shadow-size SHADOW_SIZE]
               [--rgb-outline RGB_OUTLINE] [--rgb-background RGB_BACKGROUND]
               [--rgb-shadow RGB_SHADOW] [--rgb-window RGB_WINDOW]
               input output height

Animates a long screenshot into a GIF

positional arguments:
  input                 Input screenshot image
  output                Output animated GIF
  height                Window height

optional arguments:
  -h, --help            show this help message and exit
  --pad PAD     Padding on sides
  --maxspeed MAXSPEED
                        Max speed on scroll px/frame
  --stops [STOPS [STOPS ...]]
                        Stops between scrolls, px
  --zoom-steps ZOOM_STEPS
                        Number of steps on initial zoom in
  --start-scale START_SCALE
                        Start scale
  --zoom-to ZOOM_TO     Point to zoom to
  --shadow-size SHADOW_SIZE
                        Shadow size
  --rgb-outline RGB_OUTLINE
                        Screenshot outline color
  --rgb-background RGB_BACKGROUND
                        Background color
  --rgb-shadow RGB_SHADOW
                        Screenshot shadow color
  --rgb-window RGB_WINDOW
                        Window outline color

The anishot at the top of this README was generated by: anishot --stops 290 640 940 --zoom-to 150 --start-scale .7 anishot.png anishot.gif 450

You can also experiment with styles. For example, you can go for a retro look:

anishot --stops 290 640 940 --zoom-to 150 --start-scale .7 --pad 50 --shadow-size 5 --rgb-bg #cccccc --rgb-window #666666 anishot.png anishot.gif 450

Contributing

Contributions are welcome!

anishot's Issues

Error with imageio 2.3.0

Hi,

With imageio 2.3.0 the following error occur:

$ anishot --inp ~/Images/anishot.png --out /tmp/output.git --h 200
Traceback (most recent call last):
  File "/home/herve/.local/share/virtualenvs/anishot-2ESls-8g/bin/anishot", line 10, in <module>
    sys.exit(main())
  File "/home/herve/dev/anishot/anishot/__main__.py", line 124, in main
    duration=list(map(lambda f: f[1], frames)))
  File "/home/herve/.local/share/virtualenvs/anishot-2ESls-8g/local/lib/python2.7/site-packages/imageio-2.3.0-py2.7.egg/imageio/core/functions.py", line 320, in mimwrite
    writer = get_writer(uri, format, 'I', **kwargs)
  File "/home/herve/.local/share/virtualenvs/anishot-2ESls-8g/local/lib/python2.7/site-packages/imageio-2.3.0-py2.7.egg/imageio/core/functions.py", line 170, in get_writer
    'in mode %r' % mode)
ValueError: Could not find a format to write the specified file in mode 'I'

I doesn't try with other version of imageio...

What's the current version of imageio that you use in your example on README?

Replace absl-py by python stdlib and argparse

Hi!

I would to propose to you to reduce your project dependencies by replacing absl-py (gflag) by argparse who is part of the python standard library.

Argparse is a great module and it can make the job efficiently without using a third dependency just for parsing script arguments.

Do you agree?

If you are ok with this I can easily implement it.

Give me your feedback please :)

'Can't find matching distribution' error when installing with pip on Windows 10

I have taken an interest in this project and was trying to install it on my local Windows 10 machine using pip on Python 3.7.0b3.

After typing the exact command on the repo $ pip install anishot in Command Prompt, I got the following error message:

Collecting anishot...
Could not find a version that satisfies the requirement anishot (from versions: )
No matching distribution found for anishot

To double-check, I checked the PyPI website, and found that there was no result for anishot.
Could it be that the latest version was never uploaded to PyPI, or am I reading the installation instructions wrong?