Albert HTTP Status Plugin

A lightweight Albert plugin to quickly look up HTTP status codes by number or name.

This plugin is useful for developers, DevOps engineers, and anyone working with HTTP APIs who wants fast access to status code meanings directly from Albert.

---

✨ Features

• Search HTTP status codes by number (e.g. 404, 500)
• Search by name or keyword (e.g. not found, forbidden)
• Fast, offline lookup
• No external dependencies

---

📦 Installation

Step 1: Check Your Albert API Version

First, you need to figure out which Albert API version you're running:

1. Open Albert settings
2. Go to the Python plugins section
3. Look for the API version (usually displayed as "v4.0" or "v5.0")

If you can't find it there, Albert v34.X.X uses API v5, and Albert v33.X.X uses API v4.

Step 2: Clone the Repository

git clone https://github.com/Mujtaba1i/albert-httpstatus

Step 3: Copy the Correct Version

Important: Albert only detects plugins that are directly inside the plugins folder, not in subfolders. So you need to copy the right version to the correct location.

For API v4:

cp -r albert-httpstatus/API_v4 ~/.local/share/albert/python/plugins/httpstatus

For API v5:

cp -r albert-httpstatus/API_v5 ~/.local/share/albert/python/plugins/httpstatus

Note: Only copy ONE version - the one that matches your Albert API!

Step 4: Enable the Plugin

1. Open Albert settings
2. Go to Plugins tab
3. Enable the Python plugins if it isn't already
4. Enable HTTP Status Codes

---

🚀 Usage

Use Albert's hotkey (usually Ctrl+Space or Alt+Space) and type:

• http <status_code> → e.g. http 404
• http <error_name> → e.g. http not found

---

🤔 Troubleshooting

Plugin not showing up?

• Make sure you copied the files to ~/.local/share/albert/python/plugins/httpstatus (not a subfolder!)
• Restart Albert
• Check that the Python plugin is enabled

Wrong API version?

• If the plugin doesn't work, you might have the wrong version. Delete the folder and copy the other version instead.

---

📝 License

MIT License - feel free to use and modify!

---

🙌 Contributing

Found a bug or want to add a feature? PRs are welcome!