Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nymann/crackmes-dl
Crackmes.one CLI
https://github.com/nymann/crackmes-dl
crackme crackmes reverse-engineering
Last synced: 24 days ago
JSON representation
Crackmes.one CLI
- Host: GitHub
- URL: https://github.com/nymann/crackmes-dl
- Owner: nymann
- License: gpl-2.0
- Created: 2022-04-16T03:02:37.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-02-11T23:54:17.000Z (9 months ago)
- Last Synced: 2024-10-10T18:44:16.172Z (about 1 month ago)
- Topics: crackme, crackmes, reverse-engineering
- Language: Python
- Homepage:
- Size: 37.1 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Crackmes DL
Download crackmes from using the commandline.
## Install
Requires [python3 (version >= 3.9)](https://www.python.org/downloads/) and pip
```sh
pip install --user crackmes-dl
```
Check the project out on [Pypi](https://pypi.org/project/crackmes-dl/).
## Usage
crackmes_dl supports three commands, you can figure this out by calling `crackmes_dl --help`.
### Download all
Given an output directory and a starting page (defaults to 1), download all crackmes that doesn't exists in the output directory.
```txt
$ crackmes_dl download-all --help
Usage: crackmes_dl download-all [OPTIONS]
Options:
--output-dir PATH [required]
--domain TEXT [default: https://crackmes.one]
--starting-page INTEGER [default: 1]
--help Show this message and exit.
```
### Search and download
Download only crackmes matching certain filters (as seen on ).
Note that using search and download without the `--no-quick` flag you can maximum download 50 crackmes at a time, this is due to a site restriction.
```txt
$ crackmes_dl search-and-download --help
Usage: crackmes_dl search-and-download [OPTIONS]
Options:
--output-dir PATH [required]
--domain TEXT [default: https://crackmes.one]
--quick / --no-quick Faster but limited to max 50 results
[default: quick]
--name TEXT Name of the crackme must include 'search
string'
--author TEXT Author name must include 'search string'
--difficulty-min INTEGER Difficulty greater or equal to. [default:
1]
--difficulty-max INTEGER Difficulty less or equal to. [default: 6]
--quality-min INTEGER Quality greater or equal to. [default: 1]
--quality-max INTEGER Quality less or equal to. [default: 6]
--lang [C/C++|Assembler|Java|(Visual) Basic|Borland Delphi|Turbo Pascal|.NET|Unspecified/other]
Defaults to including all
--arch [x86|X86-64|java|ARM|MIPS|other]
Defaults to including all
--platform [DOS|Mac OS X|Multiplatform|Unix/linux etc.|Windows|Windows 2000/XP only|Windows 7 Only|Windows Vista Only|Unspecificed/other]
Defaults to including all
--help Show this message and exit.
```
### Download
Download a single crackme given a `crackme_id`. This is probably only useful for scripts.
```txt
$ crackmes_dl download --help
Usage: crackmes_dl download [OPTIONS]
Options:
--output-dir PATH [required]
--crackme TEXT fx: 617965c733c5d4329c345330 [required]
--domain TEXT [default: https://crackmes.one]
--help Show this message and exit.
```
## Running in docker
Create a directory to save the crackmes.
```sh
mkdir ~/crackmes
chown -R 1000 ~/crackmes # not needed if your uid is 1000 already.
```
```sh
docker run nymann/crackmes_dl --help
# If not specifying a command, it will download all crackmes.
docker run -v ~/crackmes:/home/u/crackmes nymann/crackmes-dl
# Override the command if you want to run another one
docker run -v ~/crackmes:/home/u/crackmes nymann/crackmes-dl search-and-download --no-quick --platform "Windows" --lang "C/C++" --output-dir crackmes
```
If you want to use docker-compose:
```yml
version: "3.7"
services:
crackmes_dl:
container_name: crackmes_dl
image: nyman/crackmes_dl:latest
volumes:
- ./crackmes:/home/u/crackmes
```
## Development
For help getting started developing check [DEVELOPMENT.md](DEVELOPMENT.md)