Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


The Cable Bible

A comprehensive guide to cables and connectors potentially used for audiovisual/media preservation. Now hosted on GitHub Pages, at

You can also install the latest release on your computer with the command:

brew install amiaopensource/amiaos/cable-bible

and then call it locally with the command:


This works currently under macOS, Linux and Windows Terminal and the Linux subsystem on Windows. On classic Windows you can install the last release manually and the open index.html in a browser.


  • Ethan Gates (EG-tech)


Please feel free to clone this repository or create a new branch and submit a pull request with your own additions of modules for signal types, interfaces or connectors you think we're missing (there's a lot!).

If you're not comfortable working in GitHub, you can just supply the information and we'll be happy to add it! Please submit an issue or contact user EG-tech (Ethan Gates) with relevant descriptions, photos, info, etc.!

A Note on Inclusive Language

"Traditional" electrical and mechanical trades have sorted cable connections and fasteners in terms of "Male" (to refer to a connector or plug featuring pins or protrusions) and "Female" (to refer to a connector or plug into which pins or protrusions are inserted). The creator and maintainers of the Cable Bible find this obvious reference to a limited, cis-gendered, heteronormative understanding of human genitalia, gender, and sexual intercourse to be at best inappropriate and unnecessary, and at worst a perpetuation of harmful biases in the world at large.

The Cable Bible avoids using these classifications on the live site whenever possible. Suggested contributions should limit explanation of connections to "pins", "plugs", "sockets" or similar non-gendered terms. Maintainers will edit and enforce these terms before accepting pull requests to the main branch.

Sample images uploaded to the Cable Bible source repository do use a naming convention to indicate whether they depict a connector or port with or without pins, for clearer organization and to ease editing of the main text. In this case, the creator opted to use the terms "Cork" (to refer to a connector or plug featuring pins) and "Bottle" (to refer to a connector or plug into which pins are inserted). Again, maintainers on this repository will enforce this non-gendered naming convention on suggested contributions before accepting any pull requests to the live branch.

We acknowledge that this may cause some confusion when using the Cable Bible as a reference or educational tool, since few similar steps have been taken by cable manufacturers, vendors, or the vast majority of electrical, mechanical and technical professionals. So, a connector labeled "cork" in the Cable Bible source code should be considered equivalent to a "Male" connector elsewhere, and a "bottle" connector should be considered equivalent to a "Female" connector elsewhere.


Gathered using octohatrack

Code Contributors:

  • ablwr (Ashley)
  • EG-tech (Ethan Gates)
  • retokromer (Reto Kromer)

All Contributors:

  • ablwr (Ashley)
  • bturkus
  • eddycolloton
  • EG-tech (Ethan Gates)
  • jfarbowitz (Jonathan Farbowitz)
  • laurensorensen (Lauren Sorensen)
  • privatezero (Andrew Weaver)
  • retokromer (Reto Kromer)
  • todrobbins (Tod Robbins)
  • travislwagner

Repo: amiaopensource/cable-bible
Code Contributors: 3
All Contributors: 10

License and Attribution

Creative Commons License
This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License

Images pulled from the web are reused here under principle of fair use - they have all been downloaded and uploaded to this repository for the sake of stability, but original URLs are provided in mouse-over text.

Such enormous thanks to ablwr and the entire work of team ffmprovisr, on which so much of this project (code, spirit, COC) is based!


A guide to cables and connectors used for audiovisual tech


Code of conduct





No packages published