diff --git a/README.md b/README.md
index 233ccd647..82ccd81a5 100644
--- a/README.md
+++ b/README.md
@@ -1172,9 +1172,60 @@ appman -i --debug /path/to/your-script
 ```
 __________________________________________________________________________
 ### Third-party databases for applications (NeoDB)
-"AM"/"AppMan" can be extended by adding new application databases using a configuration file named "neodb".
+Use the option `newrepo` or `neodb` to add new repositories to use instead of this one. This works for both online and offline repositories.
 
-For more details, see the full guide at https://github.com/ivan-hc/neodb
+Set a new default repo, use "add" to append the path to a local directory or an online URL:
+```
+am newrepo add {URL}\{PATH}
+```
+or
+```
+appman newrepo add {URL}\{PATH}
+```
+then use "select" to use it by default:
+```
+am newrepo select
+```
+or
+```
+appman newrepo select
+```
+a message will warn you about the usage of this repo instead of the default one.
+
+In the screenshot below, I'm adding an offline directory and an online "RAW" fork of "AM"
+![Istantanea_2024-08-25_20-10-47](https://github.com/user-attachments/assets/599f1c11-e2dd-4343-ac51-32e0eeb2643f)
+
+Use "on"/"off" to enable/disable it:
+```
+am newrepo on
+am newrepo off
+```
+or
+```
+appman newrepo on
+appman newrepo off
+```
+Use "purge" to remove all 3rd party repos:
+```
+am newrepo purge
+```
+or
+```
+appman newrepo purge
+```
+Use "info" to see the source from where installation scripts and lists are taken.
+```
+am newrepo info
+```
+or
+```
+appman newrepo info
+```
+![Istantanea_2024-08-25_20-13-28](https://github.com/user-attachments/assets/fed5886e-5caf-4d44-83b8-c258d99c3e62)
+
+if no third-party repo is in use, you will see the default URLs from this repo.
+
+![Istantanea_2024-08-25_20-07-54 png](https://github.com/user-attachments/assets/793e64b9-7377-424c-a70e-a83e89c5225c)
 
 ------------------------------------------------------------------------