https://github.com/ananace/serial_crack
Automated password cracker for serial-connected hardware
https://github.com/ananace/serial_crack
Last synced: 14 days ago
JSON representation
Automated password cracker for serial-connected hardware
- Host: GitHub
- URL: https://github.com/ananace/serial_crack
- Owner: ananace
- License: mit
- Created: 2019-01-21T00:18:57.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-02-03T08:34:34.000Z (over 5 years ago)
- Last Synced: 2025-02-24T05:12:14.192Z (over 1 year ago)
- Language: Ruby
- Size: 10.7 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# SerialCrack
A simple password cracker for serial-connected hardware
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'serial_crack'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install serial_crack
## Usage
```
$ serial_crack --help
Usage: serial_crack [SERIAL]
-b, --bitrate BAUD choose the bitrate for communication
-d, --data BITS choose the data bits for communication
-s, --stop BITS choose the stop bits for communication
-D, --delay MS add a delay between tests
-w, --wordlist FILE use a wordlist from the given file
-r, --range RANGE add a character range
-S, --start PASSWORD start with the given password
-P, --prompt PROMPT specify the prompt to look for
-N, --no-newline skip the extra newline between password attempts
-h, --help help
```
To attempt to crack a device attached at /dev/ttyUSB0 which has a password that allows the characters `a-zA-Z0-9`;
```
$ serial_crack -r a..z -r A..Z -r 0..9 /dev/ttyUSB0
```
## Development
TODO: Write development instructions
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/ananace/serial_crack.
## License
The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).