/Codex-Project

Locks only exist to keep honest people honest.

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

Codex

ARCHIVED - See SkeletonKey

Link

Overview:

Codex is an advanced cryptography hacking tool created by a joint development between The Societal Security Guild and Cosmodium CyberSecurity. It was originally two seperate tools, one reffered to as "Codex" and the other as "The Codex Project". But on May 2, 2022, the lead developers Cythes and Blue Cosmo joined forces to build a central cryptography tool. Since then, plenty of others have joined the project to build it into what we one day hope to be, the "Metasploit of Cryptography".

Codex is capable of advanced encryption, decryption, and breaking ciphers through various mehtods. These methods include but are not limited to bruteforcing, cryptographic wordlising, letter frequencies, plaintext formatting, and cracking.

Earth Invader Discord Bot

The Earth Invader bot is a Discord API extension of Codex, bringing the same cryptography tools to Discord as if it was your own cryptography console!

See the repository here.

Requirements:

  • Debian/Void/Arch based Linux OS
  • Python 3.x

Set-Up & Installation:

  1. Clone repository
git clone https://github.com/CosmodiumCS/Codex-Project
  1. Execute installer

YES the Codex directory IS supposed to dissapear

cd Codex-Project
chmod +x
./install.sh

Supported Distros

  • Debian (debian-based)
    • Kali
    • Parrot
    • Ubuntu
  • Arch
  • Void

See --help on install.sh.

Unsupported Distros

Any unsupported distros you can use --unsupported-distro on install.sh.

In addition, you will need to install:

  • System Packages:
    • Python3
    • Python Pip
  • Python Packages
    • these can be installed after installing python pip, with pip3 install -r requirements.txt
  1. Restart your terminal

Executing Codex

Run the following for help

cryptex --help
  • The help menu will return a list of all available ciphers
  • You can append the flag for a cipher after Codex to get help for a cipher
  • Here as an example for the Caesar Cipher cc
cryptex cc
  • The returned arguments can be passed in addition
  • These arguments are the most popular among the ciphers
  • -e - encryption
  • -d - decryption
  • -b - breaking/bruteforcing
  • -k - encryption key
  • -t - input text
  • -i - input file
  • -o - output file
  • However, each cipher will have its own uniqe arguments for additional features
cryptex cc -e -t "hello world" -k 5

Cryptconsole:

The Cryptconsole is a more expansive way of using Codex. It allows the user to open a console in their terminal connected to the Codex libraries; comparable to Metasploit or OnlyRAT. The Cryptconsole can allow users to run multiple ciphers back to back to back.

  • We can execute the cryptconsole by running the following
cryptex
  • Now multiple ciphers can be run back to back with ease
[~] root@Codex $ cc -e -t "hello world" -k 5
...
[~] root@crytpex $ vc -e -t "hello world" -k hello
  • Codex also has various commands for console interaction
  • help - displays help menu
  • update - updates crytpex to latest version
  • version - displays current version
  • exit - exits cryptconsole
  • Any other command are run through the commandline

Updating Codex:

The development team will continuously be pushing out new versions of Codex. To prevent users from continously having to clone the repository, we made an update function.

  • Argument Parsing
cryptex --update
  • CryptConsole
cryptex
[~] root@cryptex $ update

Uninstalling Codex:

If at anypoint you are unsatisfied or need to rid of the Codex project [and its awesomeness]. You can run the following to get it off of your computer.

  • Argument Parsing
cryptex --remove
  • CryptConsole
cryptex
[~] root@cryptex $ remove

About Us

Soul: Lead Discord Bot Dev/Project Manager Worked on multi-distro (debian/arch/void) installer support for install.sh. Lead developer on the Earth Invader discord bot. Credited with giving Codex its colors. Also might or might not have had something to do with the original beta name "Earth Invader".

BlueCosmo: Lead Developer Started Cosmodium at 17 and since then has made significant changes in the cybersecurity community. A reasonably known content creator and python programming whiz to say the least.

Fyzz: Lead Developer
Cryptocurrency and cryptography expert, always happy to add another cipher.

Cythes: Project Manager (Retired) I started learning computers around middle school age with my discovery & passion of PC Gaming. A few years later I'd stumbled into Ubuntu 8.04 soon started learning programming, hacking on and off, while over the next decade working on projects ranging from Android personal safety applications to light game development.

Mart: Developer I started tinkering with computers I think around primary school, then in junior high school I started doing more tech stuff, then in high school I started learning more proper programming, and I began to do a lot of programming in my spare time, and at school, but I was always at least 10 steps ahead of what my class was learning, and eventually I ended up finding this place.

Testers:

  • Matze
  • Ibijon

Sponsors:

  • GamerChillz

Credits:

As an open source project, Codex and Earth Invader do use snippets of code inspired and based on other projects such as the following:

Resources: