A comprehensive guide to cables and connectors potentially used for audiovisual/media preservation. Now hosted on GitHub Pages, at https://amiaopensource.github.io/cable-bible
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:
cable-bible
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)
- Dylan Lorenz (dylanlorenz) has been temporarily added as a project maintainer to facilitate contributions to the Cable Bible in a workshop scheduled for 11/27/2023. Maintainer permissions will be revisited shortly after this date.
Please feel free to fork this repository 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.!
"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
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!