fan merinos; or how to have a little fun searching logs

At an engineering training with Greg Sabo in my first week at Stripe, he showed a cute trick: using a shell command to generate two random words when testing.

For example, every time I reconfigure my mail server, I send a distressing number of emails in this style:

echo "Testing" | mail -s "Mary Test 1" mary
echo "Testing" | mail -s "Mary Test 2" mary
echo "Testing" | mail -s "Mary Test 3" mary

(I usually lose count around Test 4, for the record.)

Likewise, in testing the Stripe create charges API function, one might run this from the documentation:

curl https://api.stripe.com/v1/charges \
-u sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
-d amount=400 \
-d currency=usd \
-d source=tok_189fCj2eZvKYlo2CjCzCPbk5 \
-d description="Charge for test@example.com"

Wouldn’t those be both more fun and somewhat easier to find in mailboxes, logs and dashboards as, say, Mary test fan merinos and Charge for cellular ascendents respectively? It would be! Thanks Greg!

Implementation-wise, on very recent Ubuntu, the trick is to add something to your bash profile along the times of:

rw () {
cat /usr/share/dict/words | grep -v "'" | grep -v "[A-Z]" | shuf -n 2 | xargs echo
}

Background: shuf is a command that behaves like head and tail, only it returns a selected number random lines. I’m filtering out single quotes (grep -v "'") in its input so as to not unduly annoy xargs, and filtering capital letters (grep -v "[A-Z]") as a proxy for filtering out proper names.

From there:
$ rw
newscaster mucky
$ echo Mary test $(rw)
Mary test equitable rough

For systems without shuf installed, there’s a lot of potential solutions to shuffling a text file at Stack Overflow, this answer has a great roundup.

As a note of caution, you don’t want to run rw live in front of other people or send them the output unchecked; a random selection of 2 English words has some reasonable chance of being disgusting, offensive, strange, inappropriate, etc. Generate some memorable phrases privately in advance!

Slightly related: xkcd: Password strength.

Change the number of words

Added 28 Sep 2016

A slightly improved version of rw that allows a variable number of words to be returned, defaulting to 2:

rw () {
  NUM=$1
  if [ -z "$NUM" ]
  then
    NUM=2
  fi
  cat /usr/share/dict/words | grep -v "'" | grep -v "[A-Z]" | shuf -n $NUM | xargs echo
}

$ rw
reverberations drumming
$ rw 1
bards
$ rw 7
protections proving unfortunately blubbered uninstallers pitchmen locality

✨ puzzlemoji ✨ WTF cake, nopetopus, ban Australia, and more!

The advent of the Slack chat program and its custom emoji and reactji has inspired me to break out Inkscape a number of times, usually mightily assisted by Open Clip Art artists, to express sentiments not yet captured by the Unicode consortium, such as NOPE or BAN AUSTRALIA.

Some of my emoji are already leaking out into the Slackerverse; it’s time to set them all free, and spread the nopetopus and no fucks far and wide! Get your puzzlemoji from the Gitlab repository or download them directly from this page.

All these emoji are public domain (I’d love to see you work out how to credit them inline), but I appreciate a shoutout where possible. In turn, credits for images I adapted can be found in “More information” links.

:banaustralia:

Let’s face it, banning Australia is the least you can do, ban early and often.

:banbrains:

When you’re feeling the need to distance yourself from your own brain, the radical action of prohibiting it may help.

:nofucks:

Inspired by the Look At All The Fucks I Give images, communicate your entire lack of fucks:

:nope: :nopetopus:

Nothing says NOPE like the nopetopus popularised (created?) by lauralex on Tumblr. For when even a cephalopod cannot be having with this nonsense:

:trashfire:

One of my most undeservedly praised emoji in terms of how much I adapted the source material! :trashfire: involved taking this image and removing several objects from it. Voilà!

:uterus: :banuterus:

There are all kinds of reasons to want to uterise your chat, both positively and negatively. The extreme ends of attitudes to uteruses can now be expressed in reactji:

:wtf: :wtfcake:

The best way to express What The Fuck sentiments is obviously and forever via baking a WTF cake (hat tip Selena Deckelmann). Now in nommable emoji form!

Other puzzlemoji

Lots of banning remains to you:

Tech interviews, too much homework, and the motherhood question

There’s a fascinating discussion around technical interviews recently; would both candidate experience and hiring signal be improved by revising the current round of (basically Google-inspired) non-runnable algorithm-centric coding examples completed under time pressure?

I’ve been following Thomas Ptacek’s tweets about it for a few months, for example:

Then last week Julia Grace wrote A Walkthrough Guide to Finding an Engineering Job at Slack:

We’ve put a great deal of effort into designing our interview process so that it is comprehensive and consistent, and are working hard to remove as many points of bias as possible. To date we’ve found it successfully identifies people who will succeed here — those with a high degree of technical competence who also embody Slack’s values: empathy, courtesy, craftsmanship, solidarity, playfulness, and thriving[…]

We’d like to get an idea of how you write code in the real world, since we feel this is the best indicator of how you’d write code day to day here at Slack. Granted, the Slack codebase is larger and more complicated than any technical exercise, but we have found the technical exercise to be a good indicator of future performance on the job. There are great engineers at big name companies and at small ones, so this gives everyone a chance to shine independent of where they are now.

This varies by position, but generally you’ll have a week to complete a technical exercise and submit the code and working solution back to us.

Uncritical praise of take home exams started to ring alarm bells for me. I recall take home exams from university; one of my majors was philosophy, which tended to assign a long essay (eg, 4000 words) to be completed over 6 weeks or so, and a take-home exam (eg, 2 essays of 1000–2000 words) to be completed with a four day deadline. I moved out of a rural town to go to university and lived on my own. From age 19, I also financially supported myself. I loathed take home exams, because I was competing with people who would get the exam, go home, and work on it all week in the house they lived in with their parents. No job. No housework. (Admittedly, no self-imposed decision to take 125% of a normal course load every year for four years of university either, that one was on me.)

And that was before I had two children. I’m not at all excited about tech interviews moving to a model where I’m doing a huge amount of work in my own time, because I do not have a huge amount of free time. Anecdotally, I have already heard of people spending in excess of 20 hours on Slack’s coding exercise. Freeing 20 hours in a week is a non-starter for me, especially if I’m not a clear finalist for the job. Slack is administering these take home assignments prior to on-site interviews, and is a very sought after workplace; it’s quite possible their process will be widely copied and people will regularly be doing a couple of days of coding before in-person interviews, for many many jobs.

To be fair, I have also read through Steve Yegge’s Get that job at Google and estimate that, at my current levels of free time, it would probably take me a couple of years to complete the preparation he recommends. (I have an undergraduate degree in computer science and mathematics — the philosophy major was a separate degree — and a PhD in computing, but at this distance I am far from passing an exam in discrete maths.) But I also wouldn’t be required to submit work samples proving I’d spent that time.

I am also aware that other positions require extensive preparatory work for job interviews for senior candidates, such as preparing sample budgets or strategy presentations or similar, but it’s at least more common only to give such large amounts of work to later-stage candidates for the position.

Let’s not get uncritically excited about adding (yet another!) screen for “isn’t a mother of young children”. I am thrilled that Camille Fournier has made several similar points in Thoughts on Take Home Interviews (also available on her blog):

On twitter, a discussion ensued about whether asking people to spend time at home doing exercises didn’t itself cause bias, against those who did not have a lot of spare time to be doing take-home exercises. Julia mentioned that they expect it to take 2–4 hours, but admitted that some people got really into the project and spent far longer than that[…]

The creative take-home also seems likely to select for those with free time, because if it is really an exercise that some people want to overdo, they will overdo it and you will have a hard time not rewarding that enthusiasm (why shouldn’t you!). And while it’s ok to ask for a few hours, building something that rewards those who can spend far longer is likely to bias against those who have, say, kids to take care of after work and on weekends, or other activities that limit their free time.

Gaëtan Voyer-Perraul also notes in a reply:

If this thing catches on, then it’s going to become a gating mechanism for every developer job in existence. New grads will be faced with hundreds of hours of “take-home” work that goes into the same black hole as their resumés.

Also worth a read: Rod Begbie gives a postmortem of a take-home interview question he used to administer.

I’m excited about revising the technical interviewing process, which will require both experimentation and evidence. While experimenting, and as the tech industry actively seeks candidates from under-represented backgrounds, the ability of candidates to interview with your organisation without tens of hours of free time for take-homes in addition to time for on-site interviews should be a core design principle for your interview process.

What should I do in Sydney?

Leigh advises if you tell a story three times, blog it. My version is “if you give advice three times…” I tend to assume that Sydney advice is fairly easy to find for visitors, but sometimes it’s better from someone you know! I’ve given advice to three separate first-time travellers to Sydney in two months, and am accordingly freeing it for you, my reading audience.

The Harbour Bridge and Opera House viewed from the north east
Sydney at night by Nigel Howe

What sort of advice is this anyway?

I’ve lived in Sydney for 17 years this year, my entire adult life. My Sydney biases: I like walking and exploring ourdoors. I like things that can be done during the day and ideally that you can take children to. I like dining out including fine dining. I’ve spent the vast bulk of my time in Sydney living without a car and tend to recommend things accessible via public transport.

There are some things I can’t help you with: I’ve never spent much time in pubs and clubs and in any case I’ve had children for more than six years so my already limited partying knowledge is pretty well atrophied now. I’m also not a serious outdoor sports person: I know you can kayak and ocean swim in Sydney but I can’t tell you where or how better than the Internet can.

Where to stay

Unless you have some reason to stay in some particular part of Sydney, stay near Circular Quay or Wynyard train stations for access to the most public transport. If you’re visiting almost entirely for the beaches, stay in Bondi or Manly.

What to do

Walk from Circular Quay past (or into) the Opera House and through the Botanical Gardens. The Opera House has performances in many genres if opera isn’t your thing.

Catch the ferry from Circular Quay to Manly. The ferry trip alone is worth it; it is one of the longer ones and you will see much of the eastern harbour. Manly is a beach suburb; you can swim at a harbour or ocean or sheltered ocean beach, do the Manly to Fairlight penguin walk or go to the aquarium.

Catch the ferry from Circular Quay to Cockatoo Island. Cockatoo Island used to be a island-sized shipyard and is now an island-sized museum of ex-shipyarding. You can ramble through giant sheds and along catwalks and so on. There’s on-island camping and glamping, the only harbour island that allows overnight stays. If an island picnic is more your thing, there are also private ferries from Circular Quay to Shark Island, which is more like a large park.

Shed interior, Cockatoo Island
Cockatoo Island by Chris Marchant, edited by Mary Gardiner

Visit the Maritime Museum at Darling Harbour. Their permanent exhibits include decommissioned naval vessels and a submarine. Have a look at the current exhibits at the Powerhouse Museum for science and technology possibilities.

Head to the beach. As above, Manly is a good choice, and in the eastern suburbs Bondi is famous and has fairly good transport. It’s also a starting point for the beautiful Bondi to Bronte coastal walk. Coogee is the beach with perhaps the next best transport options. Clovelly is a long inlet and thus very calm. Most beaches, including Bondi, Coogee, and Manly have an ocean bath – a pool filled with seawater – if you’re not up for swimming in the ocean.

Swimmer in Coogee ocean bath
Swimmer in Coogee ocean bath by Tim Gillin, edited by Mary Gardiner

The art gallery I like best is the Museum of Contemporary Art right at Circular Quay. The huge mural at the entrance is re-commissioned and painted over once a year or so, so look at the current one whenever you go. The cafe at the top has an excellent view.

I’m not done with ferries yet, you can also catch Circular Quay ferries to Luna Park, a harbourside amusement park, and to Taronga Zoo, Sydney’s best known zoo. The Gunner’s Barracks in the vicinity of the zoo is a great ramble but harder to reach from the south side of the harbour.

Luna Park ferris wheel framed against the Harbour Bridge
Luna Park,by Simon Clancy, edits by Mary Gardiner

Great walks include the Bondi to Bronte walk mentioned above, the Glebe foreshore walk and the Harbour Bridge to Manly walk (or the Spit Bridge to Manly half depending on your walking distance and available time).

The water park Wet n Wild may be more of an acquired taste, but I keep wanting to take visitors there. You don’t need to be an especially strong swimmer but a love of rollercoasters might help.

Seasonal things to look out for include the yearly Sydney Festival and Vivid festivals in summer and winter respectively. Vivid includes large light installations around the harbour and other parts of the city. There’s Sculpture By the Sea exhibits on the Bondi to Bronte walk in spring. The film festival is in June and the comedy festival in April and May.

The Museum of Contemporary Art covered in a red snake pattern
Museum of Contemporary Art lit for Vivid by MD111, edits by Mary Gardiner, CC BY-SA. Light show inspired by Jess Johnson, artist unknown.

Where to eat

Fine dining is often in flux, check recent restaurant reviews. The Boathouse at Glebe is the closest to a regular we have; it specialises in seafood. Cafe Sydney is my preferred place with a view.

For cafes and gastro pub-style eating, head to Surry Hills; bills is the best known cafe. Haymarket is the centre of Chinese food, and the other side of George Street has some great Thai places including Chat Thai.

If despite my protestations of ignorance someone insisted I choose the bar, for visitors I’d go with the Opera Bar on the lower level of the approach to the Opera House, or try out Blu Bar at the top of the Shangri-La if everyone was willing to primp for it. If your motivation is cocktails alone, the Different Drummer in Glebe is good.

Out of town

The Blue Mountains to the west are reachable as a day trip on public transport; head to Katoomba and to the Echo Point lookout.

Jervis Bay to the south is a good weekend away; you’ll likely want to drive. If you want to do some kayaking without having to deal with the boat traffic in Sydney Harbour this and several other places on the coast are good alternatives.

Image credits

Sydney by Nigel Howe.

Cockatoo Island, Sydney by Chris Marchant, cropped and colour adjusted by Mary Gardiner.

Coogee beach, Sydney pool by Tim Gillin, rotated, cropped and colour adjusted by Mary Gardiner.

Luna Park Sydney by Simon Clancy, cropped and colour adjusted by Mary Gardiner.

Vivid Sydney 2014 by MD111, rotated cropped and colour adjusted by Mary Gardiner, availabe as Creative Commons Attribution-Sharealike. The Museum of Contemporary Art light show in 2014 was inspired by artist Jess Johnson, but artist unknown and copyright presumably all rights reserved.

Make your Dreamhost site HTTPS-only

Encrypt all the traffic!

Some of the archival Ada Initiative web content is hosted on Dreamhost, and today I re-enabled HTTPS for it now that Let’s Encrypt certificates are available both on Dreamhost and WordPress.com.

Update October 2017: official Dreamhost documentation on adding an SSL certificate and forcing your site to load securely with an .htaccess file is available.

Here’s how to enable, and insist on, HTTPS connections to sites hosted on Dreamhost:

  1. Log into the panel
  2. Go to Secure Hosting
  3. Click ‘Add Secure Hosting’
  4. Select the domain you want from the dropdown, check the box next to ‘By checking this option you agree to the Let’s Encrypt Terms of Service.’, leave ‘Unique IP’ unchecked, and press ‘Add now’.
  5. Important: wait for an email from Dreamhost telling you the certificate is ready. This seems to take about fifteen minutes or so. The email contains a copy of the certificate but you don’t need to do anything with it, they configure the webserver automatically at about the same time as they send the email.
  6. Once you have received the email, check that your site is available at https://YOUR-URL and that your browswer does not report errors. (If it does, wait around 15 minutes, try again, and if you’re still seeing errors, screenshot them and contact Dreamhost support.)

Now that HTTPS is working on your site, you can then force all HTTP requests to redirect to HTTPS by placing this in the ~/YOUR-URL/.htaccess file:


<IfModule mod_rewrite.c>
# Redirect all insecure requests
RewriteCond %{HTTPS} !=on
RewriteRule ^/?(.*) https://%{SERVER_NAME}/$1 [R=301,L]
</IfModule>

# tell web browsers not to even try HTTP on this domain for the next year
# uncomment this only after you've confirmed your site is working on HTTPS, since it commits you to providing it over HTTPS
# Header set Strict-Transport-Security "max-age=31536000" env=HTTPS

Check that visiting http://YOUR-URL now redirects to https://YOUR-URL, and the same should be true of pages underneath http://YOUR-URL.

Feature request for Dreamhost: make a “force HTTPS” option in your standard config.

For more information on Strict-Transport-Security see HTTP Strict Transport Security for Apache, NGINX and Lighttpd and Stack Overflow: How to set HSTS header from .htaccess only on HTTPS.

Bonus round: update absolute links

If your site is a bunch of static HTML files, and you have done a lot of absolute linking to your own webpages, here’s a possible command you could run, replacing example.com with your own domain. I don’t recommend running it unless you know the UNIX command line, and you have a fairly good idea of what find and sed both do:


DOMAIN=example.com
cp -a ~/$DOMAIN ~/$DOMAIN-backup-before-https-edit
cd ~/$DOMAIN
find -type f -name "*.html" -exec sed -i "s/http:\/\/$DOMAIN/https:\/\/$DOMAIN/g" {} \;

Creative Commons License
Make your Dreamhost site HTTPS-only by Mary Gardiner is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Facts to definitely give when advertising your event, an incomplete list

The year. Otherwise your event for the 18th April might be in a few weeks, or it may be a stale webpage from your very successful and very over event in 2004.

The weekday. Otherwise I can’t intersect your event’s day and my (ridiculously complicated) personal calendar in my head and figure out if this is a Tuesday probably-I-could-swing-it event or a Wednesday nope-I’ll-be-in-Melbourne event without authenticating to some device and opening my calendar navigating to the day and… SQUIRREL.

If you are kind-hearted, you could add a few of very very many pieces of information suggested in the AdaCamp template lovingly brought to you by seven revisions of AdaCamps. But you can start off with the year and weekday.

Related: Terms not to use when negotiating meeting times, an incomplete list

The 92nd Down Under Feminists Carnival

This article originally appeared on Hoyden About Town.

In blue on a white background, the DUFC logo: in a square with rounded corners, there is the female/feminine symbol; with the Southern Cross inside, above which it says 'Down Under' and below 'Feminists Carnival'.

Welcome! This post is the 92nd monthly Down Under Feminists Carnival. This edition of the carnival gathers together December 2015 writing of feminist interest by writers living in Australia and New Zealand. Thanks to all the writers and submitters for making this carnival enraging, sorrowful, celebratory, and joyous in different ways and at different times.

Highlighted new(er) Down Under voices

I’ve highlighted posts that come from people who began been writing at their current home in 2015, such posts are marked with (new in 2015) after the link.

This carnival observes the rule that each writer may feature at most twice.

Race, ethnicity and racism

Celeste Liddle was angry that Andrew Bolt of all people will be centered by the ABC in the constitutional recognition of indigeonous people debate.

The inquest into the August 2014 death of Ms Dhu in custody in continued in early December (now to resume in March). December writing about Ms Dhu’s death and the inquest included:

Stephanie explored peak white person in travel writing about drug tourism to Colombia.

Bodies

Australian feminist bike zine 3rd Gear launched, with Issue #1 available and Issue #2 calling for submissions (new in 2015).

Catherine Womack swam at McIver’s Baths in Sydney; a women-and-children space.

Ashleigh Witt asked why private health insurers in Australia won’t pay for contraception?

Jo Tamar detected classist overtones in the reporting of bulk-billed IVF treatment in Australia.

Kath asked for marketing of plus-sized clothes that is unashamed and aspirational, using models in the size range of the clothes.

Rebecca shared educational information about breast cancer after another treatment.

Workplace

Stephanie made fun of the silly IBM #hackahairdryer campaign.

Deborah observed that there are more men named David running NZX-listed firms than there are women.

Harassment and abuse

Brydie Lee-Kennedy discussed her experience in the Australian comedy community as a domestic abuse survivor.

On December 1, Clementine Ford shared abusive messages she’s received online. In the followup Kerri Sackville kicked off a Twitter campaign sharing the names of men who send abusive messages on the #EndViolenceAgainstWomen hashtag. Other writeups include:

Clementine Ford, Van Badham, Lou Heinrich and Hoyden‘s own Viv Smythe spoke to Tanya Ashworth about optimism in the face of online abuse and Viv followed up about her feminist burnout.

Lauredhel invited people to resolve to oppose rape culture in 2016.

Deborah Russell condemned NZ PM John Key’s participation in a prison rape joke.

Relationships

Emily wrote about the myth of “spoiling” children by being kind and compassionate (new in 2015).

Celeste Liddle celebrated seven years of singledom.

Jo Qualmann reflected on her experiences being aromantic and asexual in a relationship.

Sky Croeser collected intersectional and anti-capitalist resources on solidarity and healing.

Media and culture

Doctor Who Season 9 wrapped up and Liz Barr mostly but not entirely liked the final three episodes.

Daily Life announced their Women of the Year finalists, with the eventual awardee being Australian Human Rights Commission President Gillian Triggs.

Scarlett Harris looked at women’s friendships in two media phenomenons: Taylor Swift’s performed-friendships and in Grey’s Anatomy.

Ju wrapped up her 2015 Australian Women Writers Challenge reading and reviewing.

Anna Kamaralli drew out less-recognised abusive parenting themes in King Lear.

Year end

2015 retrospectives included: Emily (new in 2015), A.C. Buchanan, Avril E Jean, and Rebecca.

New sites

Blogs and sites started in 2015 featured in this carnival were:

Next carnival

The 93rd carnival will follow at Zero at the Bone. Submissions to chally.zeroatthebone [at] gmail [dot] com by 2nd February 2016.

Volunteers are needed to host carnivals from April onwards. Volunteer via the contact form.

Post-Squeezebox audio setup at long last

We stuck with the Logitech Squeezebox system for streaming home audio long long past discovering that Logitech was ending development of the ecosystem but inevitably it started to date. Our Squeezebox Classic didn’t survive our house move in May. Our Squeezebox Boom and Squeezebox Radio did, but over the last year Andrew subscribed to Google Play Music, I switched to a podcasting app (Pocket Casts) for my phone rather than a command line tool that downloaded new episodes (podget), and so more and more things became phone-only and unable to easily send audio to the Squeezeboxen.

We like whole-home audio (the ability to play the same thing throughout the house), so even aside from audio quality issues, Bluetooth wasn’t going to cut it. I started to look into switching to the Sonos system, but it was another all-in system where we’d be looking at replacing all of our equipment if Sonos went out of business or end-of-lifed their setup. Logitech, you’ve done a number on the hardware side of whole-home audio systems. So we’ve switched to using good speakers with fairly cheap and disposable ecosystem adaptors, ie, the Chromecast Audio.

Software:

  • ReadyMedia (formerly MiniDLNA), which we were already using to stream video to the TV, let’s us continue having access to the audio on our Ubuntu home server
  • BubbleUPnP to send audio from the home server to the Chromecasts

ReadyMedia has to be one of the easiest to configure Linux services I’ve ever dealt with. I’m intending to play around with BubbleUPnP Server in front of ReadyMedia shortly; shared playlists are still a Squeezebox feature missing from this setup so far.

We also needed speakers to replace the Boom and Radio (we could have used their line in function, but we’ll sell them to continuing Squeezebox users). Thus, new equipment to go with the set of Yamaha MSP5 powered speakers we already have:

  • Audioengine A2+ powered speakers for my office and for our bedroom, based on the Wirecutter review of computer speakers (bonus not noted there: they come in red)
  • Rolls MX42 4-Channel Passive Mini Stereo Mixer

The mixer is something of a revelation: we’re feeding the TV audio and a Chromecast into it, in order to be able to listen to either of them through the Yamaha speakers without having to press any buttons or even use any kind of remote. Obviously we pretty much never want to listen to the TV and the Chromecast outputs simultaneously; but we can now listen to them in very rapid succession and the energy needed to decide to listen to music in the lounge room is way way lower than it was. Long may the Hamilton cast recording, Justice Crew’s Que Sera, and Doctor Who podcasts be heard around our house.

Eye-catching graphics in two minutes: a wordsmith’s guide

Graphics have been spicing up my writing and slidedecks over my fifteen years as a writer and a public speaker; the simpler and more attractive the better. But it’s not easy to put them there.

I’ve had the good fortune to also have been an amateur photographer the whole time, and have taught myself some basic image editing skills, so when I find an image that’s not quite right but could be, I pop it in an image editor, twiddle a reliable and small set of dials, and out emerges something more eye-catching. Lucky me. And lucky you: the tricks to turn a photo into something simpler and more eye-catching are simple, and today is the day I share my version of them.

Are you a wordsmith more than an visual person? Are you a writer or a public speaker who appreciates the power of a strong visual in other people’s pieces and slide decks, and wish you could just twiddle a few dials and make it happen with your own images? Do you want to make featured images for a WordPress theme, or something to break up a millionty paragraphs of text, or a colourful image to re-engage your audience in your talk? Do you sometimes have an idea of what you want but the images your searches dig up are just a bit flat for your purposes? This is for you.

This entry covers two topics: first, finding existing images that you can make work for you without any further editing. Win! And the next level: when you have an idea of what you want, and you have a photo that… doesn’t quite tell that story… but could… it’s time to make some quick and dirty edits to liven it up. Make the colours a little stronger or stranger, eliminate some clutter, and pull out some detail. Your illustrations are complete!

Eye-catching photos for wordsmiths: principles

Eye-catching images accompanying to your writing or speaking should be brain candy: simple subjects that people can identify at a glance; high contrast so that most people can understand what they’re seen quickly; and understand at a glance; and brightly or interestingly coloured because it’s eye-catching and fun. Your illustrations will usually be a subtlety-free zone.

Luckily simple, colourful, and easy to understand is an appealing set of things to have in a photo, so you’ll often be able to find free photos that you can use without editing. But there’s also a very simple set of tools that will let you take an existing photo and up its simplicity and eye-catching for your work. Finding first; then failing that, editing.

Finding images

Use photos that the photographer allows to be used and changed by other people! The Creative Commons system provides photographers and others with a way to give you this right.

To find images with Creative Commons licences that match my needs, I head on over to Flickr search, with Commercial use & mods allowed selected in the “Any licence” drop down. A couple of Flickr search tips:

  • search for generic terms. If you’re looking to make a point about time, first search for “clock” and “watch” and “sundial”, not things like “clock showing noon” or “bedside clock”. Images are often fairly generically labelled by their creator and you miss some good stuff by going specific.
  • use Flickr’s “Interesting” search tool. There’s a dropdown labelled “Relevant” — by default Flickr is trying to find images whose textual description and tags best match your search term. Try changing it to “Interesting”, to instead find somewhat matching images that are very popular on Flickr. This will often bias towards images that are already technically good, highly saturated, have an unusual subject or setting, and similar; exactly the kind of eye-catching things you want for your blog post or slide deck.

Flickr isn’t the only Creative Commons game in town: there’s also Wikimedia Commons or Google Images (after your search, go to “Search tools”, then “Usage rights” then “Labeled for reuse with modification”.

Caution: often images found this way must still be credited to their creator. Learn more here.
Caution: be careful of images with recognisable people in them. The permission you got to use the image was from the photographer, not the subject. Ethically, the person in the photo may not wish to have their likeness appear with your content, and in some cases using images of people may be restricted by personality rights or privacy rights. It’s usually best to skip images of people, or to buy them from a reputable stock image site.

[Update 2019: Tanya Reilly has surveyed more ways of finding freely licenced photos, including sites where all of the photos are Creative Commons Zero/public domain.]

Editing tools

The point of this tutorial is to make adjustments to some of the most common “knobs” you can twiddle on digital images. If you want to start making edits, and you already have a tool in mind, look up how to crop, how to auto adjust levels, how to change saturation, how to change contrast, and how to change brightness in your chosen graphics software.

In this tutorial, I’ve made the edits to images with Pinta, a free and comparatively simple graphics program for Windows, Mac, and Linux. I haven’t used them, but Paint.NET is a widely recommended equivalently straightforward Windows image editor, and Pixelmator seems highly recommended on Mac.

Editing photos to be eyecatching: short version

  1. crop the image so that the subject of interest comprises most of the image, and is off-center
  2. try auto-level colour adjustments
  3. try somewhat increasing one or more of contrast and saturation, perhaps while twiddling brightness up or down
  4. also try decreasing saturation

That’s it! If you want examples of what this looks like in action, read on!

Editing photos to be eyecatching: with examples

Meet our original images

Old Computer by Sean MacEntee. Old Computer is a surprisingly rare beast: a freely licenced photo of a computer that is being discarded. I find it easy to find great photos for search terms like apple or pen, less so for “computer in trash”. It’s a problem when you write complaints about computers a lot.

Old Computer has two major limitations if you wanted it for your condemnation of the tech industry or your rage at discarding electronics into landfill:

  • it’s “flat” colour-wise: there’s a lot of very similar beige-y colours in the image
  • there’s a lot of classroom in the shot and not a lot of computer-in-bin
A computer monitor in a bin
by Sean MacEntee

PC270246 by NickDun (hereafter called SCUBA). This is a very evocative shot of what scuba diving in a group is like and would be a great addition to your story of getting your mask kicked off by that so-and-so who probably certified yesterday, but:

  • it’s a very typical shot taken with an underwater camera, that is, it’s extremely blue-tinted
  • there’s a lot going on in it; if you want to talk about sunlight and freedom, or if you want to talk about crowds of divers, you may only want to illustrate your post with part of the image
Two divers snorkelling above a large crowd of divers
by NickDun CC BY-SA

Big Rubbish Project: Eden Project 2011 by University of Exeter (hereafter called Big Rubbish). What can I say? Garbage is a versatile metaphor and images of garbage are useful. This image is visually striking: there’s lots of repetition and patterns, and not a lot of extraneous clutter in the surrounding scene. But it also has rather dim, flat colours.

A large pile of empty plastic milk containers inside a rusted metal container.
by University of Exeter

Step 1: crop

Old Computer has an issue with a lot of surrounding space; and SCUBA has two separate things going on in it. This we are going to fix by cropping the image. Cropping means cutting out some of the photo. Where possible, you want to cut out other unrelated objects, and large expanses of foreground and background.

Cropping principle: have the object of interest filling most of the photo, slightly off center.

In Pinta, select the Rectangle Select tool, drag to draw a rectangle over the bits of the image you want to keep, and then go to the Image menu and select Crop to Selection.

Old Computer, cropped so that the computer and the bin occupy much more of the image:

A computer monitor in a bin
by Sean MacEntee, cropped by Mary Gardiner

And two crops of SCUBA, the first showing the divers snorkelling at the top of the image and the second showing the divers grouped at the bottom:

Two divers snorkelling
by NickDun, cropped by Mary Gardiner, CC BY-SA
SCUBA divers groups at bottom of ocean
by NickDun, cropped by Mary Gardiner, CC BY-SA

Honestly I’m a bit sad to crop SCUBA, because the full image is so evocative of the last two or three minutes of SCUBA dives. Let this serve as a lesson: none of this editing is compulsory. Sometimes let less be more.

I’m even more loath to crop Big Rubbish, since as I noted at in its introduction I quite like its current framing. But one possibility with cropped is to change the message of the picture a little. For example, here’s a crop that implies that the extent of the garbage could be much larger:

A large pile of empty plastic milk containers
by University of Exeter, cropped by Mary Gardiner

An even tighter crop, taking out the edges on the bottom and right could imply that it wasn’t well contained.

Having made that illustrative crop, I’ll go back to working with the full version of Big Rubbish in future steps.

Further reading: Rule of Thirds for a guideline on centering or not centering your object of interest.

Step 2: auto level

At the start, we saw that all of Old Computer, SCUBA, and Big Rubbish have “flat colours”. “Auto level” commands are the simplest way to get a good variety of colour levels to diminish this effect.

In Pinta, go to the Adjustments menu, and select Auto Level.

The effect on Big Rubbish is most dramatic and most of an improvement for eye-catching purposes (original on left, auto-levelled on right):

A large pile of empty plastic milk containers inside a rusted metal container.
by University of Exeter, duplicated and colour-adjusted by Mary Gardiner

Contrary to (my) expectations, the effect on Old Computer is extremely subtle (original on left, auto-level on right):

Two images of a computer in a bin, with slightly different colours
by Sean MacEntee, cropped, duplicated, and colour adjusted by Mary Gardiner

But don’t worry, we’re not stopping here with jazzing up Old Computer.

The effect on the two SCUBA shots is dramatic, as it often is with underwater shots. Here’s the top one (original image at top, auto-level at bottom):

Two images of two divers snorkelling, with slightly different colours
by NickDun, cropped, duplicated and colour-adjusted by Mary Gardiner, CC BY-SA

You’ll notice that while the range of colours in the auto-levelled picture is wider, it has not ended up looking especially realistic. Realistic high-fidelity underwater photographs are not easy to produce… but luckily realistic is not our goal here; our goal is striking.

Sadly, the bottom crop of SCUBA is pushing the limits of colour adjustment: if there’s really only blue in the picture, auto-level will find red where-ever it can, no matter how ill-advised (original image at top, auto-level at bottom):

SCUBA divers groups at bottom of ocean; two images in slightly different colours
by NickDun, cropped, duplicated and colour-adjusted by Mary Gardiner, CC BY-SA

Not so great. But give auto-levelling a go with any picture you are trying to edit; there’s always an Undo command.

Step 3: increase contrast and saturation

Increasing contrast increases the distinctness of the colours in the image (beyond auto-level); and increasing saturation increases their richness.

In Pinta, go to the Adjustments menu, and choose “Brightness / Contrast” for a contrast slider, and “Hue / Saturation” for a saturation slider.

Here’s Old Computer, with the Saturation slider (which starts at 100) increased to 150, and the Contrast slider (which starts at 0) increased to 30 (auto-levelled version on left, higher contrast and saturation version on right):

Two images of a computer in a bin, with different colours
by Sean MacEntee, cropped, duplicated, and colour adjusted by Mary Gardiner

And here’s Big Rubbish, with three adjustments. I took Saturation to 130, contrast up to 20, and brightness down to -50 (auto-levelled version on left, higher contrast, higher saturation version, and lower brightness version on right):

by University of Exeter, duplicated and colour-adjusted by Mary Gardiner
by University of Exeter, duplicated and colour-adjusted by Mary Gardiner

Since I’ve made it darker again, and thus more like the original, let’s keep ourselves honest and compare with the original too (original on left, auto-levelled with lower brightness, higher contrast, and higher saturation version on right):

A large pile of empty plastic milk containers, two version with different colours
by University of Exeter, duplicated and colour-adjusted by Mary Gardiner

Our version has a lot more red: the bottles are white rather than blue, and the rusty bin has a warm red tone (partly due to auto-levelling and partly due to increasing the saturation dramatically). So auto-levelling and messing with the colours paid off even though I went and reduced the brightness back down to close to the original.

Saturation is a very powerful slider: make your colours richer by increasing saturation.

That said, sometimes you can do a lot just with contrast. Remember what a mess auto-levelling made of the bottom SCUBA picture? I didn’t give up there. Here’s a version based on the original, with brightness increased to 20 and contrast to 70 (original crop on top, higher contrast and higher brightness version on bottom):

Two images of SCUBA divers groups at bottom of ocean with slightly different colours
by NickDun, cropped, duplicated and colour-adjusted by Mary Gardiner, CC BY-SA

Here manually fiddling with brightness and contrast has pulled some detail out of the picture that auto-levelling didn’t manage to find, and made it much more striking while retaining the other-worldly darkness of SCUBA diving. (Spoiler: your eyes are better than cameras at adjusting, it doesn’t seem that dark while you’re doing it. But you might want to convince your readers or listeners that it is spooky-dark…)

Step three alternative: decrease saturation

Upping saturation to make your rust warm, and your water an inviting sunny-day blue can be very effective, but it’s also worth checking out what effect you get from dialling saturation both ways.

Here’s the top of the SCUBA shot (top version auto-levelled, middle version auto-levelled with contrast increased to 20 and saturation increased to 155, bottom version with contrast increased to 35 and saturation decreased to 25):

Three images of two divers snorkelling, with different colours
by NickDun, cropped, duplicated and colour-adjusted by Mary Gardiner, CC BY-SA

Both of the edits have something to recommend them: the more saturated version in the middle looks like the sunniest dive day in the history of time, and the less saturated version at the bottom looks ethereal and dramatic; my favourite edit that I produced for this post. Try dialling saturation down sometimes, not always and forever up.

And that’s it: you have your basic dials to catch eyes now!

Two minutes to more eye-catching photos

Full disclosure: you’ll have to do a bit of practice to develop your own taste. But here’s your quick steps when you have a photo that could use a bit of “pop” before being added to your writing or your slide deck:

  1. crop the image so that the subject of interest comprises most of the image, and is off-center
  2. try auto-level colour adjustments
  3. try somewhat increasing one or more of contrast and saturation, perhaps while twiddling brightness up or down
  4. also try decreasing saturation

And so wordsmith types: go forth and give people brain candy!