dorky-app 0.1.0

Dorky is an OSINT (Open Source Intelligence) tool designed for light to medium-level dorking across multiple search engines.

Dorky

📝Intro

Dorky is a lightweight OSINT companion tool that helps you run search engine "dorks" — those advanced queries — across a range of popular search engines. It’s not magic, but it does make your life easier by handling the dirty work of reformatting and opening light to medium dorks for you.

Try it online at: dorky.uk.

✨ Highlights

Here’s what Dorky can do:

• ✅ Automatically convert Google and custom dorks for use with Google, Bing, Yandex, DuckDuckGo, Brave, and Baidu — all in one click.
• ✅ Instantly open the results in your browser for any selected engine.
• ✅ Firefox extension for easier access and quicker usage.

Under the hood, Dorky maps or approximates compatible search operators using URL tweaking.

☰ Supported Operators

Google style

• " "
• ( )
• OR, |
• -
• site:
• inurl:
• intitle:
• intext:
• filetype:, ext:
• *
• after:
• before:

Custom

• lang:
• country:
• sub:
• last:

The full list of supported operators and their compatibility can be found at dorky.uk.

🛠️ Installation

🔹 pipx (recommended)

Install with pipx:

pipx install dorky-app

Run Dorky with pipx without installing it:

pipx run dorky-app [arguments]

🔹 uv (also recommended)

Install with uv:

uv tool install dorky-app

Run Dorky with uv without installing it:

uvx dorky-app [arguments]

🔹 pip

pip install dorky-app

🚀 Getting Started

▶️ Start the Web App

By default, Dorky runs on port 8080. Launch it like this:

dorky-app start

⚙️ Change the Port if needed

Use --port or -p to pick a different port:

dorky-app start --port 8083
# or shorthand
dorky-app start -p 8083

🔐 Set the Secret Key

To store user preferences securely (like selected engines and view states), set a DORKY_SECRET environment variable. If this isn’t set, your preferences reset every time you restart.

🐳 Using Docker?

Fire up Dorky with Docker like so:

docker run -p 8080:8080 -e DORKY_SECRET="your secret" balestek/dorky-app # start dorky on port 8080
docker run -p 8083:8080 -e DORKY_SECRET="your secret" balestek/dorky-app # start dorky on port 8083

⚡ Using Dorky

Visit your local Dorky instance:

• http://127.0.0.1:8080
• http://localhost:8080

Step-by-step

1. Allow pop-ups for Dorky domain in your browser settings.
2. Click to enable the search engines you want to use.
3. Type your query or paste in your dork.
4. Hit Enter or click the search button.

🧩 Firefox Add on

Want to use Dorky directly in your browser?

🔗 Get the Add-on

🔗 Source on GitHub

It aims to provide a seamless experience, allowing you to run Dorky directly from your browser without needing to open the web app separately.

It’s already configured to work out of the box with the dorky.uk instance, but you can also point it to your own self-hosted instance of Dorky if needed.

Step-by-step

1. Install the add on.
2. Click on the add on icon and select the search engines you need.
3. (Optional) Set the Dorky URL in Advanced settings if you are using a self-hosted instance.
4. In the firefox omnibox (the address bar), type !d followed by your query or dork. For example: !d osint site:github.com.
5. Click on Search.

✔️ Requirements

Python version 3.9 or higher is required.

httpx
nicegui

📄 License

GPLv3