A polished, user-friendly command-line utility collection designed to house all my frequently used tools in one place. I am not the biggest fan of intrusive online converters with ads, paywalls, and network issues. Everything here runs cleanly and quickly right from the terminal.
Consolidated Workflow. Instead of relying on random websites to perform basic tasks like compressing an image, merging files, or converting a video to a GIF, I built this repository to act as a personal "Swiss Army Knife".
Polished Experience. The terminal doesn't have to be boring. These tools are built with user experience in mind, providing clear progress feedback and a clean interface.
Run ./mango anywhere to open the interactive hub — pick a category, drop a file, and let Mango guide the conversion.
|
Main menu Pick a category 
|
Enter choice Type 1–6
|
More detail: docs/mango-ui.md
This project is currently expanding into a comprehensive suite of offline tools divided by category.
Setup: See docs/install.md and run mango doctor to verify dependencies.
- video-to-gif: Converts a local video file into a high-quality GIF via ffmpeg. (
bin/to_gif) - extract-audio: Pull MP3/WAV tracks from video files. (
bin/extract-audio) - trim-media: Trim media duration with ffmpeg. (
bin/trim-media) - compress-video: Optimize video files for web sharing. (
bin/compress-video)
A complete offline alternative to tools like iLovePDF.
- Manipulation:
-
merge-pdf: Combine PDFs in the order you want. -
split-pdf: Separate pages into independent PDF files. -
organize-pdf: Sort, delete, or add pages to your document. -
rotate-pdf: Rotate your PDFs the way you need them. -
crop-pdf: Crop margins or specific areas of PDF documents.
-
- Conversion (From PDF):
-
pdf-to-word: Convert PDF into DOCX (text-based PDFs; scanned docs need OCR). -
pdf-to-excel: Pull data straight from PDFs into Excel. -
pdf-to-ppt: Turn PDFs into PPTX slideshows. -
pdf-to-jpg: Convert each PDF page into a JPG. -
pdf-to-md: Turn PDFs into Markdown files for notes and LLMs.
-
- Conversion (To PDF):
-
word-to-pdf: Convert DOC/DOCX to PDF. -
excel-to-pdf: Convert EXCEL to PDF. -
ppt-to-pdf: Convert PPTX to PDF. -
jpg-to-pdf: Convert images to PDF. -
html-to-pdf: Convert webpages to PDF via URL.
-
- Optimization:
-
compress-pdf: Reduce file size (Ghostscript or pymupdf fallback). -
pdf-to-pdfa: Transform to ISO-standardized PDF/A for archiving.
-
- Security & Metadata:
-
protect-pdf: Encrypt PDF documents with passwords. -
unlock-pdf: Remove PDF password security. -
sign-pdf: Request or apply electronic signatures. -
watermark-pdf: Stamp an image or text over your PDF. -
redact-pdf: Permanently remove sensitive information.
-
- Advanced / AI:
-
ocr-pdf: Convert scanned PDF into searchable documents. -
summarize-pdf: AI summarizer for articles and essays. -
translate-pdf: Translate PDF files while keeping layout intact. -
repair-pdf: Recover data from corrupt PDF files. -
pdf-forms: Create and fill interactive forms.
-
- compress-image: Compress JPEG, PNG, WebP, and GIF images locally.
- convert-image: Convert between raster formats (jpg, png, webp, gif, bmp).
- strip-exif: Remove metadata and EXIF data for privacy before sharing.
- merge-files: Combine multiple files into single archives.
- format-json: Pretty-print or minify JSON files.
- csv-to-json: Rapid conversion of data tables to JSON arrays.
- base64-tool: Encode and decode files or strings.
- hash-gen: Generate MD5, SHA-1, and SHA-256 checksums.
Full instructions: docs/install.md
One-liner (installs to ~/.local/share/mango, then runs offline):
curl -fsSL https://raw.githubusercontent.com/tmarhguy/tools/main/setup.sh | bashOr clone + setup:
git clone https://github.com/tmarhguy/tools.git && cd tools
./setup.shTyrone Marhguy — Computer Engineering '28, University of Pennsylvania
Questions or collabs — reach out.
| tmarhguy@gmail.com · tmarhguy@engineering.upenn.edu | |
| @marhguy_tyrone | |
| @tmarhguy | |
| Substack | @tmarhguy |
| GitHub | @tmarhguy |
