[github/wallabag/wallabag.git] / docs / en / user / import.rst

Migrate from a third service
============================

From Pocket
-----------

Create a new application on Pocket
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To import your data from Pocket, we use the Pocket API. You need to create
a new application on their developer website to continue.

* Create a new application `on the developer website <https://getpocket.com/developer/apps/new>`_
* Fill in the required fields: application name, application description,
  permissions (only **retrieve**), platform (**web**), accept the terms of service
  and submit your new application

Pocket will give you a **Consumer Key** (for example, `49961-985e4b92fe21fe4c78d682c1`).
You need to configure the ``pocket_consumer_key`` into the ``Import`` section in the ``Internal settings`` menu.

Now, all is fine to migrate from Pocket.

Import your data into wallabag 2.x
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Click on  ``Import`` link in the menu, on ``Import contents`` in Pocket section
and then on ``Connect to Pocket and import data``.

You need to authorize wallabag to interact with your Pocket account.
Your data will be imported. Data import can be a demanding process for your server
(we need to work on this import to improve it).

From Instapaper
---------------

*Feature not yet implemented in wallabag v2.*

From Readability
----------------

*Feature not yet implemented in wallabag v2.*

From HTML or JSON file
----------------------

*Feature not yet implemented in wallabag v2.*
Commit	Line	Data
	1	Migrate from a third service
	2	============================
	3
	4	From Pocket
	5	-----------
	6
	7	Create a new application on Pocket
	8	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	9
	10	To import your data from Pocket, we use the Pocket API. You need to create
	11	a new application on their developer website to continue.
	12
	13	* Create a new application `on the developer website <https://getpocket.com/developer/apps/new>`_
	14	* Fill in the required fields: application name, application description,
	15	permissions (only retrieve), platform (web), accept the terms of service
	16	and submit your new application
	17
	18	Pocket will give you a Consumer Key (for example, `49961-985e4b92fe21fe4c78d682c1`).
	19	You need to configure the ``pocket_consumer_key`` into the ``Import`` section in the ``Internal settings`` menu.
	20
	21	Now, all is fine to migrate from Pocket.
	22
	23	Import your data into wallabag 2.x
	24	~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	25
	26	Click on ``Import`` link in the menu, on ``Import contents`` in Pocket section
	27	and then on ``Connect to Pocket and import data``.
	28
	29	You need to authorize wallabag to interact with your Pocket account.
	30	Your data will be imported. Data import can be a demanding process for your server
	31	(we need to work on this import to improve it).
	32
	33	From Instapaper
	34	---------------
	35
	36	Feature not yet implemented in wallabag v2.
	37
	38	From Readability
	39	----------------
	40
	41	Feature not yet implemented in wallabag v2.
	42
	43	From HTML or JSON file
	44	----------------------
	45
	46	Feature not yet implemented in wallabag v2.