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 Pinboard
  49 -------------
  50
  51 Export your Pinboard data
  52 ~~~~~~~~~~~~~~~~~~~~~~~~~
  53
  54 On the backup (`https://pinboard.in/settings/backup <https://pinboard.in/settings/backup>`_) page, click on "JSON" in the "Bookmarks" section. A JSON file will be downloaded (like ``pinboard_export``).
  55
  56 Import your data into wallabag 2.x
  57 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  58
  59 Click on ``Import`` link in the menu, on ``Import contents`` in Pinboard section
  60 and then select your json file and upload it.
  61
  62 Your data will be imported. Data import can be a demanding process for your server.
  63
  64 From Instapaper
  65 ---------------
  66
  67 Export your Instapaper data
  68 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  69
  70 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``).
  71
  72 Import your data into wallabag 2.x
  73 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  74
  75 Click on ``Import`` link in the menu, on ``Import contents`` in Instapaper section
  76 and then select your CSV file and upload it.
  77
  78 Your data will be imported. Data import can be a demanding process for your server.
  79
  80 From HTML or JSON file
  81 ----------------------
  82
  83 *Feature not yet implemented in wallabag v2.*