Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/danielpclark/abrute
Multi-threaded AES Brute Force File Decryption
https://github.com/danielpclark/abrute
aes aes-encryption brute-force decryption unzip zipfile
Last synced: 2 months ago
JSON representation
Multi-threaded AES Brute Force File Decryption
- Host: GitHub
- URL: https://github.com/danielpclark/abrute
- Owner: danielpclark
- License: mit
- Created: 2017-09-18T22:38:23.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-06-05T03:02:02.000Z (over 1 year ago)
- Last Synced: 2024-10-13T15:25:57.270Z (3 months ago)
- Topics: aes, aes-encryption, brute-force, decryption, unzip, zipfile
- Language: Rust
- Homepage:
- Size: 122 KB
- Stars: 25
- Watchers: 4
- Forks: 8
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: MIT-LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/danielpclark/abrute)
# abrute - Multi-threaded AES Brute Force File Decryption
Abrute is a multi-threaded brute force file decryption tool. Many
features have been added to this including a **resume feature**, a
**JSON endpoint**, **computer clustor workload splitting**, **character
adjacency limitting**, and **custom CLI reporters**. Abrute will decrypt
the `.aes` and `.zip` extension files on any Linux compatible system.
## Installation
_abrute needs the nightly build of Rust for the TryFrom trait._
To use the install script you need to have the following commands available on your
system `curl wget unzip sudo cc` and possibly other build essentials for C.
---
For Ubuntu and Docker images of Ubuntu you can install these prerequisites with:
```bash
apt-get update && apt-get install curl wget unzip sudo build-essential
```
_NOTE: if you are not root you may need to precede `apt-get` with `sudo`_
---
The `install.sh` script will check for Rust and aescrypt and proceed to install them
if they are missing _(it will ask you if you want to install Rust)_.
First download the installation script locally.
```bash
curl https://raw.githubusercontent.com/danielpclark/abrute/master/install.sh > install.sh
```
Then verify that the contents of the installation script is safe to use (a no brainer). Then run
```bash
bash install.sh
```
This install script will use sudo to copy the binary directly to `/usr/bin` and make the
command `abrute` available to you everywhere.
### Manual Installation
First you need to have aescrypt installed.
```bash
wget https://www.aescrypt.com/download/v3/linux/aescrypt-3.13.tgz
tar -xzf aescrypt-3.13.tgz
cd aescrypt-3.13/src
make && sudo make install
cd ../.. && rm -rf aescrypt-3.13
```
Next you need to have [Rust installed](https://www.rust-lang.org/en-US/install.html).
```bash
curl https://sh.rustup.rs -sSf | sh -s -- --channel=nightly
```
Then you can get and compile abrute.
```bash
git clone https://github.com/danielpclark/abrute.git
cd abrute
cargo +nightly build --release
sudo cp target/release/abrute /usr/bin/
```
## Usage
```
USAGE: abrute [OPTIONS] --
Single digit or a range 4:6 for password length.
Characters to use in password attempt. Don't use quotes
unless they may be in the password. Backslash may escape
characters such as space.
-a, --adjacent Set a limit for allowed adjacent characters. Zero will
not allow any characters of the same kind to neighbor
in the attempts.
-s, --start Starting character sequence to begin with.
-z, --zip Use `unzip` decryption instead of `aescrypt`.
-c, --chunk Workload chunk size per core before status update.
Defaults to 32.
--cluster Takes an offset and cluster size such as 1:4 for the
first system in a cluster of 4. Helps different systems
split the workload without trying the same passwords.
-r, --reporter Use `spinner`, or `benchmark` to use a different command
line reporter.
Target file to decrypt. The target must be preceeded
by a double dash: -- target.aes
-h, --help Prints help information.
-v, --version Prints version information.
```
## License
Licensed under either of
* Apache License, Version 2.0, (http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](MIT-LICENSE) or http://opensource.org/licenses/MIT)
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any
additional terms or conditions.