Open Source Research Notebooks

A collection of Jupyter Notebooks that can be to learn or run open source investigations. We cover command line tools, scripts, and methods. We aim to help open source researchers, journalists, and fact-checkers use command line tools and code projects for digital investigations.

📰 Read our guide to code notebooks here. 📹 Watch our tutorial on Youtube: [](https://www.youtube.com/watch?v=ymCMy8OffHM)

Is this for me?

If you've used Jupyter notebooks before you should be good to navigate this right away.

If Jupyter Notebooks/Google Colaboratory don't ring any bells, you should know they are one of the easiest ways to interact with code and the command line, in essence they look like an interactive website where you execute one cell at a time to run different pieces of code, you can also edit the code and adapt it to your needs.

There's plenty of good tutorials about Jupyter Notebooks and the environments you can run them in (like Google Colab or Binder.org), we do advise you to spend 5min doing that. Additionally, we created a simple notebook that you can view (static), run on Google Colab, run on Binder, or run on Kaggle that shows the core skills needed to understand what this is all about!

Why Notebooks?

Jupyter Notebooks

• make it easier to install and run software (less "this does not work on my machine" errors)
• make it safer to run unknown code, when you run it on a Notebook service like Google Colaboratory, Binder, or Kaggle Notebooks
• make it simpler to document specific code uses: they combine styled documentation with code
• are quick to make and easy to use after you understand how to click through the code cells and edit any custom input
• can run bash commands (command line) as well as code (Python and more)

Available Notebooks

The top part of the table consists of tools and methods developed at Bellingcat; the bottom part of community developed tools and methods.	Notebook	Level	Description	Notebook links	Tags
Telegram Phone Number Checker		Check if phone numbers have associated Telegram accounts		scraping, social-media, telegram
Wayback Google Analytics		Uncover historical analytics ids via the Wayback Machine		wayback-machine, google-analytics
Geoclustering		Find clusters of incidents from a CSV of incidents		ai, clustering, gis
vk-url-scraper		Scrape data and download media from VKontakte URLs		scraping, social-media
Search Grid Generator		Generate grid in KML file for systematic area searches.		geolocation, maps
-	-	-	-	-
OpenAI Whisper		AI audio/video transcription and translation		ai, speech-recognition
Holehe		Find accounts associated with an email		digital-footprint-tracing
Maigret		Find accounts associated with a username		digital-footprint-tracing
Wayback Machine Downloader		Download an entire website from the Wayback Machine.		wayback-machine
YT-DLP		Download and manipulate videos from hundreds of online platforms. Includes advanced commands with Python.		archiving, media-downloads
ExifTool		Extract and analyse file metadata tags		digital-forensics, metadata
Deepface		AI face comparison and analysis		ai, image-analysis

• Entry level notebooks, you need only know how to run cells and edit specific values
• Notebooks that require higher technical know-how, or previous setups
• Notebooks that require technical understanding or adapting code