---
title: "Bechdel.io"
description: "Bechdel.io: Does your favorite movie pass the Bechdel Test?"
url: https://www.joekarlsson.com/work/bechdel-io/
---

2015 | with Laurel Karlsson | Node.js, NLP, JavaScript, MongoDB

# Bechdel.io

**Works** Does your favorite movie pass the Bechdel Test?

[See it live →](https://bechdel.joekarlsson.com/) | [View on GitHub →](https://github.com/JoeKarlsson/bechdel-test) | [Read why I built it](https://www.joekarlsson.com/talks/bechdel-io-how-we-used-javascript-to-help-make-film-more-inclusive/)

On this page

1.  [Artist statement](https://www.joekarlsson.com/work/bechdel-io/#statement)
2.  [Try it](https://www.joekarlsson.com/work/bechdel-io/#play-it)
3.  [How it’s made](https://www.joekarlsson.com/work/bechdel-io/#how-its-made)
4.  [Lineage](https://www.joekarlsson.com/work/bechdel-io/#lineage)

## Artist statement

**[1](https://www.joekarlsson.com/work/bechdel-io/#mn-w-1)** She stole it from a friend, Liz Wallace, whose name is on the marquee in the comic strip, reprinted below.[Alison Bechdel, The Rule](https://dykestowatchoutfor.com/the-rule/)

Most people who hear about the Bechdel Test go looking for a movie they love that fails it, and a lot of them find one. The test comes from a 1985 strip in Alison Bechdel’s comic [1](https://www.joekarlsson.com/work/bechdel-io/#mn-1) Dykes to Watch Out For. A character says she’ll only see a movie if it has two women in it, they talk to each other, and they talk about something besides a man, and the joke is that the last one she saw was Alien.

**[1](https://www.joekarlsson.com/work/bechdel-io/#mn-w-1)** She stole it from a friend, Liz Wallace, whose name is on the marquee in the comic strip, reprinted below.[Alison Bechdel, The Rule](https://dykestowatchoutfor.com/the-rule/)

**[2](https://www.joekarlsson.com/work/bechdel-io/#mn-w-2)**

[Rereading Hackers and Painters as a painter who codes with AI agents](https://www.joekarlsson.com/blog/hackers-and-painters-ai-agents/): How I rebuilt it as a static site in 2026, after it died on Heroku.

Bechdel.io reads the screenplay [2](https://www.joekarlsson.com/work/bechdel-io/#mn-2) and asks those three questions the same way for every film, including the ones you love. The whole original Star Wars trilogy fails, and so do The Godfather, Back to the Future and The Shawshank Redemption. They sit on the same shelf as the films that pass, under the same pass or fail tag.

**[3](https://www.joekarlsson.com/work/bechdel-io/#mn-w-3)** Guerrilla Girls, Do Women Have To Be Naked To Get Into the Met. Museum?, 1989. Tate collection. [tate.org.uk](https://www.tate.org.uk/art/artworks/guerrilla-girls-do-women-have-to-be-naked-to-get-into-the-met-museum-p78793)

Counting has been a feminist tool for a long time. In 1989 the Guerrilla Girls counted the art [3](https://www.joekarlsson.com/work/bechdel-io/#mn-3) at the Met and put the numbers on a poster: fewer than 5% of the artists in the modern art sections were women, but 85% of the nudes were female. Anyone can sit through one movie with a notebook and check it, and one failing movie is easy to wave off. Bechdel.io runs the same check across a director’s career or a year of releases, where it gets a lot harder to call any one film an exception.

**[4](https://www.joekarlsson.com/work/bechdel-io/#mn-w-4)**

[Bechdel.io - How We Used JavaScript To Help Make Film More Inclusive](https://www.joekarlsson.com/talks/bechdel-io-how-we-used-javascript-to-help-make-film-more-inclusive/): The talk: how the parser reads a script, and why Laurel and I built it.

We made it open source as feminist activism [4](https://www.joekarlsson.com/work/bechdel-io/#mn-4), so anyone can run the count on the movies they care about.

## Try it

Pick a movie to see whether it passes. [Open it full screen →](https://bechdel.joekarlsson.com/)

[![Bechdel.io: the headline “Do two women talk to each other about something other than a man?”, the shelf of movie posters marked passes or fails, filtering to films that pass, then the Gone Girl page scoring 3 of 3 and its cast sized by lines spoken](https://www.joekarlsson.com/images/projects/bechdel-io-2026-poster.webp)](https://bechdel.joekarlsson.com/)

## Screenshots

![The Bechdel.io shelf: search, show and sort controls over a grid of movie posters, each tagged passes or fails with its year and how many of the three rules it meets](https://www.joekarlsson.com/images/projects/bechdel-io-2026-shelf.webp)

The shelf: 218 films, 111 of them pass

![The Gone Girl page: release details, then the cast sized by lines spoken, with Nick at 496 lines in white and Amy at 287 and Boney at 196 in pink for women](https://www.joekarlsson.com/images/projects/bechdel-io-2026-lines.webp)

Each film page sizes the cast by how many lines they speak

## How it’s made

Node.js, NLP, JavaScript, MongoDB

The scripts came from [Movie Script Scraper](https://github.com/JoeKarlsson/movie-script-scraper), and the cast from a film database API. [The 2015 write-up](https://www.joekarlsson.com/blog/bechdel-test-script-parser-works/) goes deeper.

It has two weak spots. Words about men run all through English, and a keyword can’t tell what a sentence is about. And it takes each character’s gender from the film database, which credits everyone as an actor or an actress, so it can’t see a trans or nonbinary character.

_Diagram: How Bechdel.io reads a screenplay: it gets the cast and each credited gender from a film database, splits the script into scenes, and checks every scene with two or more women for words about a man_

## Lineage

Led to

[Movie Script Scraper](https://www.joekarlsson.com/work/movie-script-scraper/): A Node CLI and npm package that downloads movie scripts by genre from the Internet Movie Script Database. Tim Kendall started it in 2014; I rewrote it and published it to npm in 2018, and it’s where Bechdel.io’s scripts came from. 2018 | 14 stars | Node.js, Cheerio, npm

[Project page for Movie Script Scraper](https://www.joekarlsson.com/work/movie-script-scraper/) | [Source for Movie Script Scraper](https://github.com/JoeKarlsson/movie-script-scraper)

Next in the same vein

[Rose Hobart](https://www.joekarlsson.com/work/rose-hobart/): Joseph Cornell’s 1936 collage film, with the tint, the speed and the music back in your hands while it plays. 2017 | 2 stars | Astro, TypeScript, WebGL2

[Project page for Rose Hobart](https://www.joekarlsson.com/work/rose-hobart/) | [Source for Rose Hobart](https://github.com/JoeKarlsson/rose-hobart) | [Demo for Rose Hobart](https://rosehobart.joekarlsson.com/)

## Works on My Machine

If you liked this project, you might like what I write: homelab builds, AI tools and open source, by email when I have something to say.

It’s free, and you can unsubscribe anytime. You’ll get an email to confirm first.

![Joe Karlsson at his desk, chin on hand, with a microphone in front of him](https://www.joekarlsson.com/images/about/collage/studio.webp)

Joe  
Karlsson

Technology is better when it's weird and it's yours. Everything I write about runs in my house.

[More about me →](https://www.joekarlsson.com/about/)

[Bluesky](https://bsky.app/profile/joekarlsson.com) | [LinkedIn](https://www.linkedin.com/in/joekarlsson/) | [GitHub](https://github.com/JoeKarlsson)
