]> git.immae.eu Git - github/wallabag/wallabag.git/blob - docs/en/user/import.rst
Merge pull request #2420 from wallabag/redis-tests
[github/wallabag/wallabag.git] / docs / en / user / import.rst
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
32 From Readability
33 ----------------
34
35 Export your Readability data
36 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
37
38 On the tools (`https://www.readability.com/tools/ <https://www.readability.com/tools/>`_) page, click on "Export your data" in the "Data Export" section. You will received an email to download a json (which does not end with .json in fact).
39
40 Import your data into wallabag 2.x
41 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
42
43 Click on ``Import`` link in the menu, on ``Import contents`` in Readability section
44 and then select your json file and upload it.
45
46 Your data will be imported. Data import can be a demanding process for your server.
47
48 From Instapaper
49 ---------------
50
51 Export your Instapaper data
52 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
53
54 On the settings (`https://www.instapaper.com/user <https://www.instapaper.com/user>`_) page, click on "Download .CSV file" in the "Export" section. A CSV file will be downloaded (like ``instapaper-export.csv``).
55
56 Import your data into wallabag 2.x
57 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
58
59 Click on ``Import`` link in the menu, on ``Import contents`` in Instapaper section
60 and then select your CSV file and upload it.
61
62 Your data will be imported. Data import can be a demanding process for your server.
63
64 From HTML or JSON file
65 ----------------------
66
67 *Feature not yet implemented in wallabag v2.*