]> git.immae.eu Git - github/wallabag/wallabag.git/blame - docs/en/user/import.rst
Merge pull request #1558 from wallabag/v2-documentation
[github/wallabag/wallabag.git] / docs / en / user / import.rst
CommitLineData
10b40f85
NL
1Migrate to wallabag
2===================
3
4From wallabag 1.x
5-----------------
6
7Export your data from your wallabag 1.x
8~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
9
10On your config page, click on ``JSON export`` in the ``Export your wallabag data`` section.
11
12.. image:: ../../img/user/export_wllbg_1.png
13 :alt: Export from wallabag 1.x
14 :align: center
15
16You will have a ``wallabag-export-1-1970-01-01.json`` file.
17
18Import your data into wallabag 2.x
19~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20
21Click on ``Import`` link in the menu, select your export file on your computer and import it.
22
23.. image:: ../../img/user/import_wllbg.png
24 :alt: Import from wallabag 1.x
25 :align: center
26
27All your wallabag 1.x articles will be imported.
28
29From Pocket
30-----------
31
a42938f4
NL
32Create a new applicaton on Pocket
33~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
34
35To import your data from Pocket, we use the Pocket API. You need to create a new application on their developer website to continue.
36
37* Create a new application `on the developer website <https://getpocket.com/developer/apps/new>`_
38* Fill in the required fields: application name, application description, permissions (only **retrieve**), platform (**web**), accept the terms of service and submit your new application
39
40Pocket will give you a **Consumer Key** (for example, `49961-985e4b92fe21fe4c78d682c1`). You need to configure the ``pocket_consumer_key`` into the ``app/config/parameters.yml`` file in wallabag.
41
42Now, all is fine to migrate from Pocket.
43
44Import your data into wallabag 2.x
45~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
46
47Click on ``Import`` link in the menu, on ``Import contents`` in Pocket section and then on ``Connect to Pocket and import data``.
48
49You 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).
50
10b40f85
NL
51From Instapaper
52---------------
53
a42938f4
NL
54*Feature not yet implemented in wallabag v2.*
55
10b40f85
NL
56From Readability
57----------------
58
a42938f4
NL
59*Feature not yet implemented in wallabag v2.*
60
10b40f85
NL
61From HTML or JSON file
62----------------------
a42938f4
NL
63
64*Feature not yet implemented in wallabag v2.*