diff --git a/README.md b/README.md
index 611ba41..ecc7c43 100644
--- a/README.md
+++ b/README.md
@@ -1,39 +1,78 @@
-# roc droid
+# Roc for Android!
-**Table of contents:**
+[![Build](https://github.com/roc-streaming/roc-droid/actions/workflows/build.yml/badge.svg)](https://github.com/roc-streaming/roc-droid/actions/workflows/build.yml) [![GitHub release](https://img.shields.io/github/release/roc-streaming/roc-droid.svg)](https://github.com/roc-streaming/roc-droid/releases) [![Matrix chat](https://matrix.to/img/matrix-badge.svg)](https://app.element.io/#/room/#roc-streaming:matrix.org)
-- [roc droid](#roc-droid)
- - [Temporary organization of files](#temporary-organization-of-files)
- - [Documentation](#documentation)
+Android app implementing Roc sender and receiver. **Work in progress!**
-## Temporary organization of files
+Features:
-* roc-droid Kotlin implementation files are temporarily stored in special temp folder
+* **receive** sound from remote Roc-compatible sender and **play** to local audio device
+* **capture** sound from apps or microphone and **send** to remote Roc-compatible receiver
-* folder location: [temp_storage](/temp_storage/)
+## Installation
-* This part is planned to be reimplemented/copied back in the issue: https://github.com/roc-streaming/roc-droid/issues/98
+### From repository
-## Documentation
+Download from F-Droid or IzzyOnDroid:
-Architecture:
+[](https://f-droid.org/packages/org.rocstreaming.rocdroid/)
+[](https://apt.izzysoft.de/fdroid/index/apk/org.rocstreaming.rocdroid)
-* **Overview** – [Application architecture description](/docs/architecture_overview.md)
+### From binaries
-* **UI** – [User interface architecture description](/docs/architecture_ui.md)
+Download pre-built APK from latest [github release](https://github.com/roc-streaming/roc-droid/releases/latest).
-* **Model** – [Model architecture description](/docs/architecture_model.md)
+### From sources
-* **Agent** – [Agent architecture description](/docs/architecture_agent.md)
+Follow instructions here: [build project](https://roc-streaming.org/droid/building/build_project).
-Automation:
+## Screenshot
-* **doit automation** - [Description of application automation (doit)](/docs/automation.md)
+
-Tests:
+## Features
-* **Unit testing** - [Unit testing description](/docs/unit_tests.md)
+Roc Droid is based on [Roc Toolkit](https://github.com/roc-streaming/roc-toolkit) streaming engine, which notable features are:
-Setups:
+* real-time streaming with guaranteed latency;
+* robust work on unreliable networks like Wi-Fi, due to use of Forward Erasure Correction codes;
+* CD-quality audio;
+* multiple profiles for different CPU and latency requirements;
+* relying on open, standard protocols, like RTP and FECFRAME;
+* interoperability with both Roc and third-party software.
-* **Flutter - Windows** - [Windows Flutter setup](/docs/install_win.md)
+Compatible senders and receivers include:
+
+* [cross-platform command-line tools](https://roc-streaming.org/toolkit/docs/tools/command_line_tools.html)
+* [modules for sound servers](https://roc-streaming.org/toolkit/docs/tools/sound_server_modules.html) (PulseAudio, PipeWire, macOS CoreAudio)
+* [C library](https://roc-streaming.org/toolkit/docs/api.html) and [bindings for other languages](https://roc-streaming.org/toolkit/docs/api/bindings.html)
+
+## Donations
+
+If you would like to support the project financially, please refer to [this page](https://roc-streaming.org/toolkit/docs/about_project/sponsors.html). This project is developed by volunteers in their free time, and your donations will help to spend more time on the project and keep it growing.
+
+Thank you!
+
+
+
+## Hacking
+
+Contributions in any form are very welcome! You can find issues needing help using [help wanted](https://github.com/roc-streaming/roc-droid/labels/help%20wanted) and [good first issue](https://github.com/roc-streaming/roc-droid/labels/good%20first%20issue) labels.
+
+Please refer [to documentation](https://roc-streaming.org/droid/) to get an idea about project internals and development process.
+
+Welcome to join our matrix chat rooms for [users](https://app.element.io/#/room/#roc-streaming:matrix.org) and [developers](https://app.element.io/#/room/#roc-streaming-dev:matrix.org).
+
+Authors
+-------
+
+See [here](https://github.com/roc-streaming/roc-droid/graphs/contributors).
+
+License
+-------
+
+[MPL-2.0](LICENSE)
diff --git a/_temp_storage/README.md b/_temp_storage/README.md
deleted file mode 100644
index 237b863..0000000
--- a/_temp_storage/README.md
+++ /dev/null
@@ -1,162 +0,0 @@
-# Roc for Android!
-
-[![Build](https://github.com/roc-streaming/roc-droid/actions/workflows/build.yaml/badge.svg)](https://github.com/roc-streaming/roc-droid/actions/workflows/build.yaml) [![GitHub release](https://img.shields.io/github/release/roc-streaming/roc-droid.svg)](https://github.com/roc-streaming/roc-droid/releases) [![Matrix chat](https://matrix.to/img/matrix-badge.svg)](https://app.element.io/#/room/#roc-streaming:matrix.org)
-
-Android app implementing Roc sender and receiver. **Work in progress!**
-
-Features:
-
-* **receive** sound from remote Roc-compatible sender and **play** to local audio device
-* **capture** sound from apps or microphone and **send** to remote Roc-compatible receiver
-
-Download
---------
-
-* Download APK from [latest release](https://github.com/roc-streaming/roc-droid/releases/latest)
-
-* Download from F-Droid or IzzyOnDroid:
-
-[](https://f-droid.org/packages/org.rocstreaming.rocdroid/)
-[](https://apt.izzysoft.de/fdroid/index/apk/org.rocstreaming.rocdroid)
-
-Screenshot
-----------
-
-
-
-Features
---------
-
-Key features of [Roc Toolkit](https://github.com/roc-streaming/roc-toolkit) streaming engine, used by Roc Droid:
-
-* real-time streaming with guaranteed latency;
-* robust work on unreliable networks like Wi-Fi, due to use of Forward Erasure Correction codes;
-* CD-quality audio;
-* multiple profiles for different CPU and latency requirements;
-* relying on open, standard protocols, like RTP and FECFRAME;
-* interoperability with both Roc and third-party software.
-
-Compatible senders and receivers include:
-
-* [cross-platform command-line tools](https://roc-streaming.org/toolkit/docs/tools/command_line_tools.html)
-* [modules for sound servers](https://roc-streaming.org/toolkit/docs/tools/sound_server_modules.html) (PulseAudio, PipeWire, macOS CoreAudio)
-* [C library](https://roc-streaming.org/toolkit/docs/api.html) and [bindings for other languages](https://roc-streaming.org/toolkit/docs/api/bindings.html)
-
-## Donations
-
-If you would like to support the project financially, please refer to [this page](https://roc-streaming.org/toolkit/docs/about_project/sponsors.html). This project is developed by volunteers in their free time, and your donations will help to spend more time on the project and keep it growing.
-
-Thank you!
-
-
-
-Building
---------
-
-The app uses [Java bindings for Roc Toolkit](https://github.com/roc-streaming/roc-java). You don't need to install them manually; gradle will automatically download AAR from maven central, which contains both libroc and Java bindings built for all Android ABIs.
-
-The easiest way to build the app is using Android Studio.
-
-Alternatively, you can build and deploy APK from command-line.
-
-Build:
-
-```
-./gradlew build
-```
-
-Install to device:
-
-```
-adb install app/build/outputs/apk/debug/roc-droid-*.apk
-```
-
-Development
------------
-
-To check code style use:
-
-```
-./gradlew spotlessCheck
-```
-
-To apply code style use:
-
-```
-./gradlew spotlessApply
-```
-
-To check consistency of version name and code:
-
-```
-./gradlew checkVersion
-```
-
-Signing
--------
-
-Keystore with certificates was generated using this command:
-
-```
-keytool -genkey -v -keystore roc-droid.jks -alias apk -keyalg RSA -keysize 2048 -validity 10000
-```
-
-Then it was encoded to base64:
-
-```
-base64 roc-droid.jks
-```
-
-Then the following secrets were added to the repo:
-
-* `SIGNING_STORE_BASE64` - base64-encoded keystore (`roc-droid.jks`)
-* `SIGNING_STORE_PASSWORD` - keystore password
-* `SIGNING_KEY_ALIAS` - key alias (`apk`)
-* `SIGNING_KEY_PASSWORD` - key password (same as keystore password)
-
-GitHub actions decode `SIGNING_STORE_BASE64` into a temporary `.jks` file and set `SIGNING_*` environment variables with the name of the file and credentials.
-
-Then the following command is run:
-
-```
-./gradlew assembleRelease
-```
-
-It reads credentials from the environment variables and signs release APK using them.
-
-Release
--------
-
-To release a new version:
-
-* Create git tag
-
- ```
- ./tag.py --push
- ```
-
- e.g.
-
- ```
- ./tag.py --push origin 1.2.3
- ```
-
- Or use **tag.py** without **--push** to only create a tag locally, and then push it manually.
-
-* Wait until "Release" CI job completes and creates GitHub release draft.
-
-* Edit GitHub release created by CI and publish it.
-
-Authors
--------
-
-See [here](https://github.com/roc-streaming/roc-droid/graphs/contributors).
-
-License
--------
-
-[MPL-2.0](LICENSE)