Needle
github.com
- Free plan
- Linux
What Needle is
Needle is a free, open-source Python testing library for checking website visuals and layout. It captures selected page areas and compares each capture with a saved baseline screenshot, helping identify visual regressions. Tests can also inspect rendered CSS, fonts, images, SVGs, calculated CSS values, and HTML element positions. Needle works with Selenium and nose, and its documentation installs it with pip after Selenium. Browser options include Firefox, remote, PhantomJS, Chrome, Internet Explorer, Opera, and Safari, with NeedleFirefox as the default. PIL is the default image engine; PerceptualDiff and ImageMagick are alternatives that can create a diff PNG when comparisons fail. Viewport dimensions can be set for responsive-site checks. Screenshot cleanup after successful tests is optional and disabled by default, while failed captures remain available. Needle targets developers, runs on Linux, and carries a BSD license. PyPI lists version 0.5.0, released April 2, 2017.
Who it suits
Needle suits developers building Python-based visual and CSS regression tests. It is relevant when Selenium and nose workflows, browser viewport checks, and cross-browser captures are needed.
Good to know, and what to watch
- Free open-source package
- Compares captures with baseline screenshots
- Checks CSS values and element positions
- Supports multiple browser drivers
- Allows responsive viewport testing
- Latest listed release dates to 2017
- Linux is the listed platform
- Screenshot cleanup is off by default
- No SECURITY.md policy or advisories
Plans
Every plan and priceNeedle
Open source
The verdict
Needle brings screenshot comparison and layout assertions into Selenium and nose testing. Its browser and image-engine options cover several visual-check workflows, though the listed release is old.
What the maker publishes
- Additional checks
- It also provides tools for testing calculated CSS values and HTML element positions. source
- Baseline workflow
- Tests can save an initial screenshot as a baseline and compare later captures against it to detect regressions. source
- Browser automation
- Needle works with Selenium and nose. source
- Browser drivers
- The documentation lists NeedleRemote, NeedlePhantomJS, NeedleFirefox, NeedleChrome, NeedleIe, NeedleOpera, and NeedleSafari drivers. source
- Cleanup
- Screenshot cleanup after successful tests is optional and disabled by default. source
- Cleanup behavior
- Screenshot files are kept by default after successful tests, with an option to delete them; screenshots from failing comparisons remain available for inspection. source
- Comparison engines
- The documented screenshot engines are PIL, PerceptualDiff, and ImageMagick; PerceptualDiff and ImageMagick can produce diff images when tests fail. source
- Default driver
- The documentation says Needle uses NeedleFirefox by default. source
- Difference output
- The documentation says PerceptualDiff and ImageMagick generate a diff PNG when a test fails. source
- Image engines
- The default screenshot engine is PIL, with PerceptualDiff and ImageMagick also available. source
- Installation
- The documentation installs Needle with pip after installing Selenium. source
- Installation
- The documentation installs Needle with pip and lists Selenium as a dependency to install. source
- Integrations
- Needle is designed to work with Selenium and nose. source
- Integrations
- The README demonstrates a nose test case using Selenium to open a web page and check an element screenshot. source
- Intended users
- The package metadata classifies Needle for developers and as a Python testing library. source
- License
- The repository includes a BSD license. source
- License
- The package metadata classifies Needle under the OSI-approved BSD License. source
- Purpose
- Needle tests CSS and website visuals by capturing page areas and comparing them with baseline screenshots. source
- Purpose
- Needle tests CSS and other web visuals by comparing screenshots with known good screenshots. source
- Release
- PyPI lists version 0.5.0, released April 2, 2017, as the latest release. source
- Security
- GitHub reports that the project has no SECURITY.md policy and no published security advisories. source
- Supported environments
- Package metadata describes Needle as operating-system independent and intended for developers. source
- Viewport
- Tests can set browser viewport dimensions, which the documentation describes as useful for responsive-site testing. source
- Viewport testing
- Needle lets tests set browser viewport dimensions, including for responsive site testing. source
Checked against the maker's pages on 10 Oct 2026.