I decided not to contribute anymore to Weboob as I don't want to legitimate the views of the project. This is a personal clone, likely unmaintained.

INSTALL 2.8KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687
  1. Woob installation
  2. =================
  3. Using the packages provided by your distribution is recommended.
  4. See http://woob.tech/install for a list of available packages.
  5. Since there are many dependencies, when you install from sources,
  6. you have to handle them by hand, according to your distribution.
  7. The requirements are provided in ``setup.py``, except for:
  8. * gpgv (for secure updates). If not packaged alone, it should be in ``gnupg`` or ``gpg``.
  9. * For more performance, ensure you have ``libyaml`` and ``simplejson`` installed.
  10. Some modules may have more dependencies.
  11. After a package or system installation, you should run ``woob config update``
  12. as your login user.
  13. There are 2 versions of woob:
  14. * stable: for end-users, only modules are updated on this version, not the core or apps
  15. * master: for development, modules and core libs and apps are updated frequently
  16. End-user installation (stable version)
  17. --------------------------------------
  18. No need to use the git repository in this case. Just
  19. $ pip install --user woob
  20. This pip installation can be run within a virtualenv if desired (don't add ``--user``).
  21. Then `woob-config update` can be run to fetch the list of available modules,
  22. and the various woob commands (woob bank, woob video, etc.) can be run and are able
  23. to install modules.
  24. Developer installation (master version)
  25. ---------------------------------------
  26. There is a way to install woob locally without messing with your system.
  27. $ pip install --user -e .
  28. The scripts are copied to ``~/.local/bin``.
  29. This pip installation can be run within a virtualenv if desired (don't add ``--user``).
  30. Developer installation (master version, alternative)
  31. ----------------------------------------------------
  32. There is a way to install woob locally without messing with your system.
  33. Run ``./tools/local_install.sh`` as your local user. ::
  34. $ ./tools/local_install.sh ~/bin
  35. The scripts are copied to ``~/bin``.
  36. System installation (discouraged)
  37. ---------------------------------
  38. The install mode copies files to the Python system-wide packages directory (for
  39. example ``/usr/lib/python3.7/dist-packages`` for Python 3.7. ::
  40. # pip install --system .
  41. Scripts are copied to ``/usr/bin``.
  42. No installation mode (master version)
  43. -------------------------------------
  44. This does not actually install anything, but lets you run Woob from the
  45. source code, while also using the modules from that source. This is only
  46. recommended if using the git source and not a release. ::
  47. $ ./tools/local_run.sh APPLICATION COMMANDS
  48. For example, instead of running ``woob video -b youtube search plop``, you would
  49. run::
  50. $ ./tools/local_run.sh woob video -b youtube search plop
  51. Bash completion
  52. ---------------
  53. To enable bash completion, just source the ``tools/woob_bash_completion``
  54. file from your ``~/.bashrc`` file.