Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (testpypi.python.org).
Help us improve Python packaging - Donate today!

A command line tool to aid in the development of banner ad campaigns. Auto generates PSDs at the required sizes with specified filenames to get you started, then when done designing, exports static banners at or under max file sizes specified. All managed via a very simple manifest file.

Project Description

Overview

A couple of command line helpers to (1) auto-generate blank PSDs at specific sizes with desired filenames and (2) automatically save static image versions without going over predefined max file sizes. Very useful for people who design and develop a lot of banner ad campaigns.

Requirements

  • Python 2.7.x
  • ImageMagick
  • pngquant

NOTE: This has only been tested on a Mac (10.10.2) at this time.

Installation

You can install directly via pip:

pip install Banner-Ad-Toolkit

Or from the BitBucket repository (master branch by default):

git clone https://bitbucket.org/tsantor/banner-ad-toolkit
cd banner-ad-toolkit
sudo python setup.py install

Usage

Create a Manifest

Both command line tools are governed by a manifest file. Create an Excel doc with the following column headers and add as many rows as needed for each banner size you need:

Type Width Height Max Size Prefix Suffix
Static 300 600 40KB PREFIX (optional) SUFFIX (optional)
Static 160 600 40KB PREFIX (optional) SUFFIX (optional)
Static 300 250 40KB PREFIX (optional) SUFFIX (optional)
Static 728 90 40KB PREFIX (optional) SUFFIX (optional)

NOTE: Columns may be in any order. You may add any additional columns you need, but they will be ignored.

  • Type: Static, Flash or anything else, however Flash types will be ignored (currently) by the tools.
  • Max Size: File size should be defined using KB or MB (eg - 40KB, 1MB)
  • Prefix: A prefix to prepend to your file name
  • Suffix: A suffix to append to your file name

NOTE: File names will be generated as PREFIX_WIDTHxHEIGHT_SUFFIX

Export as CSV

Export (Save As) your Excel doc as a CSV.

Generate PSDs

Once you have your manifest CSV, we can auto-generate blank PSDs at specific sizes with desired filenames. Simply run the following command:

adkit-generate /path/to/manifest.csv /path/to/output

NOTE: For all available commands, run adkit-generate -h

Export Deliverables

Once all your banner PSDs are complete, ensure they are saved in their ‘static’ state. This will automatically save static image versions without going over predefined max file sizes defined in the manifest. Simply run the following command:

adkit-export /path/to/manifest.csv /path/to/input/

NOTE: For all available commands, run adkit-export -h

Version History

  • 0.1.0 - Initial release
  • 0.1.1 - Small tweaks
  • 0.1.2 - Added ability to handle paths with spaces

Issues

If you experience any issues, please create an issue on Bitbucket.

Release History

History Node

0.2.0

History Node

0.1.7

History Node

0.1.6

History Node

0.1.5

This version
History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
Banner-Ad-Toolkit-0.1.2.tar.gz
(8.8 kB) Copy SHA256 Hash SHA256
Source Apr 8, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting