CLI tool to get and view stylised CTFTime.org writeups in your terminal.
Project description
ctft
ctft is a python cli tool to save and view stylised ctftime.org writeups locally in your terminal.
- Search for writeups by name or keyword
- View Stylised writeups from saved files
- Writeups are saved are as markdown files which can also be read as plaintext(even though it doesn't make sense to read plaintext over formatted :unamused: )
VSCode users can also use markdown viewing extensions like Markdown Preview Enhanced to view writeups
The project took inspiration from mzfr's lswriteups but I wanted to further the ease of access and reduce browser dependence.
The tool currently scrapes only writeups on CTFTime.org and github READMEs. If you would like to add support for your site or your favourite author(with their permission ofcourse), feel free to contact me or make a pull request
Usage
➜ python3 ctft.py -h
usage: ctft [-h] (-e EVENT | -v TASK NAME)
Get and view stylised ctftime writeups in your terminal
optional arguments:
-h, --help show this help message and exit
-e EVENT, --event EVENT
Name of the ctf event
-v TASK NAME, --view TASK NAME
View writeup in terminal
- The files are saved in your (home directory)/ctft_writeups
DEMO
python3 ctft.py -e asisctf
You can also make an alias of ctft or add ctft to $PATH for easier usage
ctft -v Web\ Warm-up
Installation
pip3 install ctft
Manual Installation
- Cone the repo:
git clone https://github.com/bajatin/ctft
- Install dependencies:
pip install -r requirements.txt
Contributing
I started this project solely for educational purposes to familiarize myself with python and asynchronous programming. Pull requests or suggestions for imporvement are welcome. For major changes, please open an issue first to discuss what you would like to change.
License
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.