Skip to content

Commit 3e7f392

Browse files
cleaned-documentation
1 parent 2eebd7f commit 3e7f392

3 files changed

Lines changed: 84 additions & 146 deletions

File tree

README.MD

Lines changed: 81 additions & 143 deletions
Original file line numberDiff line numberDiff line change
@@ -1,214 +1,152 @@
11
<!-- variables -->
22
[ccs]: https://www.cosmodiumcs.com
3-
[ssg]: https://www.saintssec.com
43
[youtube]: https://www.youtube.com/c/CosmodiumCS
54
[onlyrat]: https://github.com/CosmodiumCS/OnlyRAT
65

76
<!-- title -->
87
# SkeletonKey V1.1
98

10-
Under Development!
11-
12-
### Added:
13-
- Salt and Raw Hash Function to MD5
14-
- SHA1 to SHA512 Hashes
15-
- Blake2b and Blake2s Hashes
16-
- Twofish Encryption
17-
- Blowfish Encryption
18-
- Updated Pixel Encoding
19-
- Monoalphabetic Cipher
20-
- URL Encoding
21-
22-
### Plan:
23-
- Windows Capable
24-
- Fernet Encryption
25-
- AES Encryption
26-
- RSA Encryption
27-
- 3/DES Encryption
28-
- Compression Methods
29-
- Fast Hash Brute Force Option
30-
- Extend SHA Library
31-
32-
---
33-
34-
SkeletonKey is an advanced cryptography hacking tool created by a joint development between [The Societal Security Guild](https://saintssec.com) and [Cosmodium CyberSecurity][ccs]. It was originally two seperate tools, one reffered to as "[Cryptex](https://github.com/SSGorg/Cryptex)" and the other as "[The Codex Project](https://github.com/CosmodiumCS/the-codex-project)". But on May 2, 2022, the lead developers [Cythes](https://github.com/AlexKollar) and [Blue Cosmo](https://github.com/CosmodiumCS) joined forces to build a central cryptography tool.
35-
36-
---
37-
38-
## Hacktoberfest 2022
39-
Hacktoberfest is a celebration of open-source software, which we are all a advocate for. We believe that you should be able to modify software to work as you need. This is why we are participating in [Hacktoberfest 2022](https://hacktoberfest.com). Successfully making 4 contributions on any participating project will net you some prizes which you can see on the link above.
40-
41-
## How to contribute
42-
You can contribute by adding anything in the month of October; (any other time not be counted as part of the event, but you are still welcome to contribute) in the form of a [pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request). Simply make a fork of the project, make your changes, and create a pull request to the main project with those changes.
43-
44-
Be sure to check the issue board if you're not sure how to help!
45-
46-
We will review your changes, suggest edits if needed, and if all checks out - we will add it to the project. If your additions are accepted, they will be merged to the main branch, and your pull request will be marked as Hacktoberfest accepted!
47-
48-
Generally, any contribution you make will be included at the bottom of this README as credit to your work.
49-
50-
---
51-
52-
## Earth Invader Discord Bot
53-
The Earth Invader bot is a Discord API extension of SkeletonKey, bringing the same cryptography tools to Discord as if it was your own cryptography console!
54-
55-
See the repository [here](https://github.com/Soulsender/Earth-Invader).
56-
9+
> A Cryptographic Suite Created by The CosmodiumCS Development Team
5710
---
58-
<!-- EMBED YOUTUBE VIDEO HERE -->
5911

60-
## Requirements
61-
- Debian/Void/Arch based Linux OS
12+
## Update 1.2:
13+
- Code Transcript Cracking
14+
- Salt and Raw Hash Function to MD5
15+
- SHA1 to SHA512 Hashes
16+
- Blake2b and Blake2s Hashes
17+
- Twofish Encryption
18+
- Blowfish Encryption
19+
- Updated Pixel Encoding
20+
- Monoalphabetic Cipher
21+
- URL Encoding
22+
23+
## Overview:
24+
SkeletonKey is an advanced cryptography hacking tool created by [Cosmodium CyberSecurity][ccs] (with an original joint development with SSG). It was originally refereed to as "[The Codex Project](https://github.com/CosmodiumCS/the-codex-project)", and later "Cryptex" after a joint development. After a group conflict, the CCS developers left the group to create "SkeletonKey", which aims to become a leading cryptographic hacking suite. SkeletonKey is capable of advanced encryption, decryption, and breaking ciphers through various methods. These methods include but are not limited to brute-forcing, cryptographic word-listing, letter frequencies, plaintext formatting, and cracking.
25+
26+
## Resources:
27+
- [YouTube Video](https://www.cosmodiumcs.com/comings-soon)
28+
- [YouTube Channel](https://youtube.com/cosmodiumcs)
29+
- [Website](https://cosmodiumcs.com)
30+
- [Earth Invader](https://github.com/Soulsender/Earth-Invader) (SkeletonKey Discord Bot)
31+
32+
## Requirements:
33+
- Linux OS (Debian/Void/Arch)
6234
- Python 3.x
6335

64-
## Set-Up & Installation
36+
## Installation:
6537
1. Clone repository
66-
```
38+
```bash
6739
git clone https://github.com/CosmodiumCS/SkeletonKey
6840
```
6941
2. Execute installer
7042
> **YES** the SkeletonKey directory **IS** supposed to disappear
71-
```
43+
```bash
7244
cd SkeletonKey
7345
chmod +x
7446
./install.sh
7547
```
76-
7748
3. Restart your terminal
7849

79-
### Supported Distros
80-
- Debian (debian-based)
81-
- Kali
82-
- Parrot
83-
- Ubuntu
84-
- Mint
85-
- Arch
86-
- Void
87-
88-
> See `--help` on `install.sh`.
89-
90-
### Unsupported Distros
91-
Any unsupported distros you can use `--unsupported-distro` on `install.sh`.
92-
93-
In addition, you will need to install:
94-
- System Packages:
95-
- Python3
96-
- Python Pip
97-
- Python Packages
98-
- these can be installed after installing python pip, with `pip3 install -r requirements.txt`
99-
100-
101-
102-
## Executing SkeletonKey
50+
## Running SkeletonKey:
10351
Run the following for help
104-
```
52+
```bash
10553
key --help
10654
```
10755
- The help menu will return a list of all available ciphers
10856
- You can append the flag for a cipher after `key` to get help for a cipher
10957
- Here as an example for the Caesar Cipher `cc`
110-
```
58+
```key
11159
key cc
11260
```
11361
- The returned arguments can be passed in addition
11462
- These arguments are the most popular among the ciphers
11563
- `-e` - encryption
11664
- `-d` - decryption
117-
- `-b` - breaking/bruteforcing
65+
- `-b` - breaking/brute-forcing
11866
- `-k` - encryption key
11967
- `-t` - input text
12068
- `-i` - input file
12169
- `-o` - output file
122-
- However, each cipher will have its own uniqe arguments for additional features
123-
```
70+
- However, each cipher will have its own unique arguments for additional features
71+
```bash
12472
key cc -e -t "hello world" -k 5
12573
```
12674

127-
## Cryptconsole
128-
The Cryptconsole is a more expansive way of using SkeletonKey. It allows the user to open a console in their terminal connected to the SkeletonKey libraries; comparable to [Metasploit](https://www.metasploit.com/) or [OnlyRAT][onlyrat]. The Cryptconsole can allow users to run multiple ciphers back to back to back.
129-
- We can execute the cryptconsole by running the following
130-
```
75+
## Keyconsole:
76+
The *Keyconsole* is a more expansive way of using SkeletonKey. It allows the user to open a console in their terminal that is directly connected to the SkeletonKey libraries (comparable to [Metasploit](https://www.metasploit.com/) or [OnlyRAT][onlyrat]). The *Keyconsole* can allow users to run multiple ciphers back to back to back.
77+
- We can execute the *Keyconsole* by running the following:
78+
```bash
13179
key
13280
```
13381
- Now multiple ciphers can be run back to back with ease
134-
```
82+
```bash
13583
[~] root@SkeletonKey $ cc -e -t "hello world" -k 5
13684
...
13785
[~] root@SkeletonKey $ vc -e -t "hello world" -k hello
13886
```
13987
- SkeletonKey also has various commands for console interaction
14088
- `help` - displays help menu
141-
- `update` - updates crytpex to latest version
89+
- `update` - updates SkeletonKey to latest version
14290
- `version` - displays current version
143-
- `exit` - exits cryptconsole
144-
- Any other command are run through the commandline
91+
- `exit` - exits Keyconsole
92+
- Any other command are run through the command line
14593

146-
## Updating SkeletonKey
147-
The development team will continuously be pushing out new versions of SkeletonKey. To prevent users from continously having to clone the repository, we made an update function.
148-
- Argument Parsing
149-
```
94+
## Updating SkeletonKey:
95+
The development team will continuously be pushing out new versions of SkeletonKey. To prevent users from continuously having to clone the repository, we made an update function.
96+
- **Argument Parsing**:
97+
```bash
15098
key --update
15199
```
152-
- CryptConsole
153-
```
100+
- **Keyconsole**:
101+
```bash
154102
key
155103
[~] root@SkeletonKey $ update
156104
```
157105

158-
## Uninstalling SkeletonKey
159-
If at anypoint you are unsatisfied or need to rid of the SkeletonKey project [and its awesomeness]. You can run the following to get it off of your computer.
160-
- Argument Parsing
161-
```
106+
## Uninstalling SkeletonKey:
107+
If at any point you are unsatisfied with the SkeletonKey project [and its awesomeness], You can run the following to get it off of your computer.
108+
- **Argument Parsing**:
109+
```bash
162110
key --remove
163111
```
164-
- CryptConsole
165-
```
112+
- **Keyconsole**:
113+
```bash
166114
key
167115
[~] root@SkeletonKey $ remove
168116
```
169-
---
170-
171-
## About Us
172-
**[Soul](https://soulsender.github.io): Lead Discord Bot Dev / Shellscripter / Project Manager**
173-
Worked on multi-distro (debian/arch/void) installer support for `install.sh`. Lead developer on the [Earth Invader](https://github.com/Soulsender/Earth-Invader) discord bot. Credited with giving SkeletonKey its colors. Also might or might not have had something to do with the original beta name "Earth Invader".
174117

175-
**[BlueCosmo](https://github.com/PrettyBoyCosmo): Lead Python / Shellscript Developer**
176-
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.
177-
178-
**[Fyzz](https://github.com/FyzzLive): Lead Python Developer**
179-
Cryptocurrency and cryptography expert, always happy to add another cipher.
118+
## Earth Invader Discord Bot:
119+
The Earth Invader bot is a Discord API extension of SkeletonKey, bringing the same cryptography tools to Discord as if it was your own cryptography console! Check it out [here](https://github.com/Soulsender/Earth-Invader).
180120

181-
**[Cythes](https://github.com/AlexKollar): Project Manager (Retired)**
182-
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.
183-
184-
**[Mart](https://github.com/marvhus): Developer (Retired)**
185-
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.
186-
187-
## Testers
188-
- Matze
189-
- Ibijon
190-
191-
## Sponsors
192-
- GamerChillz
193-
194-
---
195-
196-
## History
197-
SkeletonKey is an advanced cryptography hacking tool created by a joint development between [The Societal Security Guild](https://saintssec.com) and [Cosmodium CyberSecurity][ccs]. It was originally two seperate tools, one reffered to as "[Cryptex](https://github.com/SSGorg/Cryptex)" and the other as "[The Codex Project](https://github.com/CosmodiumCS/the-codex-project)". But on May 2, 2022, the lead developers [Cythes](https://github.com/AlexKollar) and [Blue Cosmo](https://github.com/CosmodiumCS) joined forces to build a central cryptography tool.
198-
199-
On August 10th of the same year, due to inner group conflict, many of the developers of Cryptex left to build their own tool named "SkeletonKey".
200-
201-
SkeletonKey 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.
202-
203-
---
121+
## FAQ:
122+
**What Linux distributions are supported?**
123+
- Debian (debian-based)
124+
- Kali
125+
- Parrot
126+
- Ubuntu
127+
- Mint
128+
- Arch
129+
- Void
130+
> See `--help` on `install.sh`.
204131
205-
## Credits
132+
**What Linux distributions are not supported?**
133+
- With any unsupported distributions, you can use `--unsupported-distro` on `install.sh`.
134+
- In addition, you will need to install:
135+
- **System Packages**:
136+
- Python3
137+
- Python Pip
138+
- P**ython Packages**:
139+
- After installing python pip, use `pip3 install -r requirements.txt`
140+
141+
## Original Devs:
142+
- Blue Cosmo
143+
- Fyzz
144+
- Soulsender
145+
- Haze
146+
147+
## Credits:
206148
As an open source project, SkeletonKey and Earth Invader do use snippets of code inspired and based on other projects such as the following:
207-
208149
- [OnlyRAT](https://github.com/CosmodiumCS/OnlyRAT)
209150
- [Nirsoft](https://www.nirsoft.net)
210151
- [Satux](https://cosmodiumcs.com/coming-soon)
211-
- [Scarab](https://github.com/Soulsender/Scarab)
212-
213-
## Resources
214-
- [Discord](https://discord.gg/tTKv8w8sHH)
152+
- [Scarab](https://github.com/Soulsender/Scarab)

main.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ def update():
3333
print("\n[*] Checking for updates...")
3434

3535
# get latest version nubmer
36-
os.system("curl https://raw.githubusercontent.com/AlexKollar/SkeletonKey/master/version.txt | tee ~/.SkeletonKey/latest.txt")
36+
os.system("curl https://raw.githubusercontent.com/CosmodiumCS/SkeletonKey/main/version.txt| tee ~/.SkeletonKey/latest.txt")
3737

3838
# save version nubmers to memory
3939
current_version = float(open(f"{b.local_path}/version.txt", "r").read())
@@ -271,7 +271,7 @@ def cli(args_exist):
271271
elif user_input.split(' ')[0] not in get_ciphers():
272272
os.system(user_input)
273273

274-
# runs crytpex libraries
274+
# runs skeletonkey libraries
275275
else:
276276
os.system(f'python3 ~/.SkeletonKey/main.py {user_input.replace("key", "")}')
277277

version.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
1.1
1+
1.2

0 commit comments

Comments
 (0)