kmymoney/doc/details-impexp-woob.docbook

0001 <sect1 id="details.impexp.woob">
0002   <sect1info>
0003     <author>&Dawid.Wrobel; &Dawid.Wrobel.mail;</author>
0004     <author>&Jack.H.Ostroff; &Jack.H.Ostroff.mail;</author>
0005   </sect1info>
0006
0007   <title>Woob Importer</title>
0008   <sect2>
0009     <title>What is Woob?</title>
0010     <para>
0011       <ulink url="https://woob.tech/">Woob</ulink> (short for <quote>Web outside of
0012       browsers</quote>) is is <quote>a collection of applications able to interact with websites,
0013       without requiring the user to open them in a browser</quote>. One of <ulink
0014       url="https://woob.tech/applications/">such applications</ulink> allows specifically to
0015       interact with <ulink url="https://woob.tech/applications/bank">financial
0016       institutions</ulink>. &kmymoney; provides a plugin that employs it directly, therefore
0017       allowing to import transactions from account at those institutions which otherwise do not
0018       offer support for any other financial protocol that &kmymoney; handles.
0019     </para>
0020
0021     <note>
0022       <para>
0023         &kmymoney; currently requires that you install Woob independently. Refer to the following
0024         sections for details.
0025       </para>
0026     </note>
0027   </sect2>
0028   <sect2>
0029     <title>Installing Woob</title>
0030     <para>
0031       An increasing number of Linux distributions provide a package for Woob, and this is
0032       preferable, if one is available for you.
0033     </para>
0034     <para>
0035       You need to install Python 3 first before continuing.  All Linux distributions provide
0036       packages for Python, but you can always download a package for your system from the <ulink
0037       url="https://www.python.org/downloads/">official website</ulink>.
0038     </para>
0039
0040     <para>
0041       With Python 3 installed, you should now be able to easily download and install required Woob
0042       modules.  Please refer to the instructions on <ulink url="https://woob.tech/install/">Woob
0043       website</ulink>.
0044     </para>
0045   </sect2>
0046   <sect2>
0047     <title>Using Woob</title>
0048     <para>
0049       &kmymoney; uses the <quote>woob bank</quote> module.
0050     </para>
0051   </sect2>
0052 </sect1>