diff --git a/README.md b/README.md
index 4f3808e..dcdf6de 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,38 @@
-# Madari
+# Open Source Media Manager
 
+An open-source media manager app built with Flutter, designed to stream videos from Stremio addons. This project aims to provide an easy-to-use platform for managing and streaming media content.
+
+## Features
+- **Stream Videos** from various Stremio addons.
+- **Cross-Platform Support**: Works on Android, iOS supported by Flutter.
+- **Open Source**: Contributions are welcome!
+
+## Screenshots
+
+<img src="readme/image/home.jpg" width="250" title="Home Page">
+
+## Getting Started
+
+### Prerequisites
+- Dart SDK and Flutter installed on your machine.
+- Ensure you have all necessary dependencies for Flutter projects.
+
+### Local Development
+To build and run the project locally, use the following command:
+
+```bash
+dart run build_runner build --delete-conflicting-outputs
+```
+
+### Running the App
+1. Clone this repository.
+2. Navigate to the project directory.
+3. Run the app using Flutter's run command:
+
+```bash
+flutter run
+```
+
+## Contributing
+Contributions, issues, and feature requests are welcome!  
+Feel free to fork the repository and submit a pull request.
diff --git a/readme/image/home.jpg b/readme/image/home.jpg
new file mode 100644
index 0000000..13c512a
Binary files /dev/null and b/readme/image/home.jpg differ