Skip to content

lsnnt/chotadhobi-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ChotaDhobi CLI

A command-line interface for managing laundry services through the ChotaDhobi API.

Demo

asciicast

Installation

Desktop (Linux / macOS / Windows)

  1. Clone the repository:

    git clone https://github.com/lsnnt/chotadhobi-cli
    cd chotadhobi-cli
  2. Create a virtual environment (optional but recommended):

    python3 -m venv venv
    source venv/bin/activate       # macOS / Linux
    # venv\Scripts\activate        # Windows
  3. Install dependencies:

    pip install -r requirements.txt

Mobile (Termux on Android)

For a fresh Termux install, run these commands in order:

# 1. Update package lists and upgrade existing packages
pkg update && pkg upgrade -y

# 2. Install required system packages
pkg install -y python git

# 3. Clone the repository
git clone https://github.com/lsnnt/chotadhobi-cli
cd chotadhobi-cli

# 4. Install Python dependencies
pip install -r requirements.txt

Tip: If you see QR codes rendering incorrectly, install a Termux-compatible font or try increasing your terminal font size. The Termux:Styling add-on can help.

Usage

python3 main.py

Features

  • Login — Authenticate using your VIT email and OTP
  • Send Clothes — Request a wash with a specified number of clothes
  • Receive Clothes — View recent washes and display QR codes for collection
  • View History — Browse your complete wash history and show the QR code for any record
  • User Details — Display your account information
  • Credential Storage — Securely store and reuse login credentials via a local .env file

How It Works

  1. On first run, you'll be prompted to log in with your VIT email.
  2. An OTP will be sent to your email — enter it to authenticate.
  3. Your credentials (token and email) are saved locally in a .env file.
  4. On subsequent runs, you can reuse saved credentials or log in again.
  5. Use the menu to perform actions like sending or collecting clothes.

QR Code for Collection

When sending or collecting clothes, a QR code is displayed in the terminal containing the wash_id. Show this QR code to the laundry staff for verification.

Security

  • The .env file is git-ignored and never committed to version control.
  • Your token and email are stored locally only.
  • All requests are made over HTTPS.

Responsible AI Disclosure

main.py was generated with AI assistance based on the reverse-engineered API docs. The API documentation itself was independently researched and written by the author.

Credits

Claude for python scripts cli writing Reverse engineered by @lsnnt

About

Reverse Engineered Chotadhobi App used in VIT for laundary services exposing its backend apis

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages