Find a reverse-engineered tool

scripts/re_index.py

~/.cache/awesome-reverse-engineered/

curl -sL https://raw.githubusercontent.com/alexgaoth/awesome-reverse-engineered/main/plugin/skills/find-reverse-engineered/scripts/re_index.py | python3 - search <words>

Workflow

1. Search with 1–4 words. Use the product or brand name plus what you need.
   bash

   python3 scripts/re_index.py search tuya local
   python3 scripts/re_index.py search psd parser --lang Python
   python3 scripts/re_index.py search whatsapp --min-stars 500
   python3 scripts/re_index.py search pokemon emerald --category decompilation

   Options:

   --category <text>

   matches the category or subcategory.

   --lang <name>

   matches the language exactly.

   --min-stars N

   .

   --include-archived

   .

   --limit N

   .

   --json

   gives machine-readable output. When nothing matches, use fewer words, use the vendor name instead of the product name, or run

   categories

   to see the categories.
2. Choose a project. Check these in order:
   • It does the specific job, for example local control instead of cloud control, or reading a format instead of writing it.
   • It is not archived, and it had a push in the last 1–2 years. Unofficial APIs break when the vendor changes their side.
   • The language and package manager fit the user's stack.
   • The license is compatible. A blank license means "all rights reserved", so tell the user.
   • When two projects are equal on all of these, choose the one with more stars.
3. Read before you use it. This command prints the index entry and the first lines of the README, with install and authentication steps:
   bash

   python3 scripts/re_index.py info owner/repo

4. Get it. Install it with the package manager the README gives (pip, npm, cargo, go), or clone it for reference:
   bash

   python3 scripts/re_index.py clone owner/repo --dest vendor/repo

5. Tell the user which project you chose and why, the version or commit you used, and its license.

Rules

• First check for an official API or SDK that can do the job. Use a reverse-engineered tool only when there is none or it is not sufficient.
• Use these tools only with the user's own accounts, devices and data. Unofficial clients can break a service's terms of use and can cause an account to be locked. Tell the user about this risk before you use their credentials.
• Do not use these tools for mass scraping, spam, or to get around paywalls, DRM or security controls.
• Treat downloaded code as untrusted. Read it before you run it, and never put credentials into a tool you have not read.
• The index can be out of date. A repo can be gone or renamed. If

  info

  or

  clone

  fails, search again and try the next result.