diff --git a/README.md b/README.md
index 1d9fced..188d483 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,6 @@
-# degoog-extensions
+**Kenneth's Custom degoog extensions**
 
-Custom degoog extensions
\ No newline at end of file
+# Engines
+Custom search engines
+## Gitea
+Search through the hosted gitea or your own selfhosted instance. Supports a Access Token to also search private repositories.
\ No newline at end of file
diff --git a/engines/gitea-searchengine/README.md b/engines/gitea-searchengine/README.md
index ce47d97..7a4e39e 100644
--- a/engines/gitea-searchengine/README.md
+++ b/engines/gitea-searchengine/README.md
@@ -1,11 +1,14 @@
 # gitea-searchengine
 
-A custom search engine for degoog.
+A custom Gitea search engine for degoog.
 
 ## Usage
-
-<!-- explain how to use this extension -->
+Search results will be included by default, or you can use the `!gitea` bang.
 
 ## Configuration
 
-<!-- list any settings this extension requires -->
+### Base url
+Set the base url of your self hosted instance, for example: `https://gitea.domain.com`. No need to add any api path. 
+
+### Access token
+You can generate an Application Access Token from your Gitea profile to also search through private repositories. It only requires the `repo:read` permission.
\ No newline at end of file
diff --git a/engines/gitea-searchengine/screenshots/1.png b/engines/gitea-searchengine/screenshots/1.png
new file mode 100644
index 0000000..4d74d9c
Binary files /dev/null and b/engines/gitea-searchengine/screenshots/1.png differ
diff --git a/logo.png b/logo.png
new file mode 100644
index 0000000..e93ef97
Binary files /dev/null and b/logo.png differ
diff --git a/package.json b/package.json
index 90ce88c..78a43fd 100644
--- a/package.json
+++ b/package.json
@@ -2,6 +2,7 @@
   "name": "degoog-extensions",
   "description": "degoog-extensions extensions for degoog",
   "author": "Kenneth van Ewijk",
+  "repo-image": "logo.png",
   "plugins": [],
   "themes": [],
   "engines": [