diff --git a/readme.md b/readme.md
index 0761d4f..53ce7bd 100644
--- a/readme.md
+++ b/readme.md
@@ -2,8 +2,22 @@
 
 ## SoundTouch git repository moved to codeberg.org
 
-2021-10-14 OP: For some reason that currently is unknown to us, gitlab.com blocked soundtouch account without any prior or posterior notice, hence soundtouch repository moved to codeberg.org, hopefully a more stable and friendly home for an opensource project.
+The soundtouch repository has moved from gitlab.com to [codeberg.org](https://codeberg.org/soundtouch/soundtouch).
 
+Please accordingly switch to use the new repository location:
+* www: https://codeberg.org/soundtouch/soundtouch
+* clone:
+  ```
+  git clone https://codeberg.org/soundtouch/soundtouch.git
+  ```
+* switch your existing git checkout to use the codeberg repository:
+  ```
+  git remote set-url origin https://codeberg.org/soundtouch/soundtouch.git
+  ```
+
+This move is because gitlab.com blocked soundtouch account in mid-October without any prior notice, making it unavailable also for external developers and projects depending on it. That's not a great way to collaborate.
+
+The gitlab eventually re-enable our account after a week of waiting, yet hopefully gitberg provides a more stable and friendly home for an opensource project.
 
 ## About