diff --git a/README.md b/README.md
index 0c075f8..1c8b99b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,48 @@
-# odoo-export
+# exportoo
 
-Exports odoo models and datas to flat files (JSON or TSV)
\ No newline at end of file
+Exports odoo models and datas to flat files (JSON or TSV)
+
+## Usage
+
+### Sessions
+First you have to login
+`./odoo-rpc.py login [<server> [<port> [<database> [<user> [<passwd>]]]]]`
+
+Any information not given as param is prompted
+
+```bash
+$ ./odoo-rpc.py login localhost 8069
+Server address: localhost
+Port: 8069
+Connected to localhost:8069
+Available databases:
+db1
+db2
+db3
+Database: |
+```
+
+Once login success, the session is saved under `~/.odoorpcrc`
+
+### Api
+
+```
+./odoo-rpc.py <model> <method> [<param> [<param> [<param>]]]
+
+# List all databases
+./odoo-rpc.py db list
+
+# Search models with domains
+./odoo-rpc.py ir.model search model = res.users		# exact model
+./odoo-rpc.py ir.model search model like product	# model names containing 'product'
+./odoo-rpc.py res.users search company_id.id = 42	# users of company 42
+./odoo-rpc.py product.template search name = 'Awesome product'
+./odoo-rpc.py product.template search create_uid.name like john
+./odoo-rpc.py product.uom search id != -1			# all entries
+
+# List model's fields
+./odoo-rpc.py product.template fields
+
+# Save entries as json files on disk (!!! Recursively followinf many2one and one2many fields)
+./odoo-rpc.py product.template export-json create_uid.name like john
+```