Backup_Repos/beets
1
0
Fork 0
mirror of https://github.com/beetbox/beets.git synced 2025-12-06 08:39:17 +01:00
Code Issues Projects Releases Wiki Activity

Re-added macport instructions. Removed mailing list ref. Added section

Browse source 
header for pip and pipx. Removed python 3.13 attention.
This commit is contained in:
Sebastian Mohr 2025-09-09 12:25:05 +02:00
parent e30772f0c1
commit 7caa68a141
2 changed files with 13 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
docs/guides/main.rst
View file

@ -13,17 +13,20 @@ Beets requires Python 3.9 or later, you will need to install that first.
Depending on your operating system, you may also be able to install beets from a Depending on your operating system, you may also be able to install beets from a
package manager, or you can install it with pipx_ or pip_. package manager, or you can install it with pipx_ or pip_.
Using pip(x) Using ``pipx``
~~~~~~~~~~~~ ~~~~~~~~~~~~~~
To use the most recent version of beets, we recommend installing it with pipx_, To use the most recent version of beets, we recommend installing it with pipx_.
the Python package manager. If you don't have pipx_ installed, you can follow If you don't have pipx_ installed, you can follow the instructions on the `pipx
the instructions on the `pipx installation page`_ to get it set up. installation page`_ to get it set up.
.. code-block:: console .. code-block:: console
pipx install beets pipx install beets
Using ``pip``
~~~~~~~~~~~~~
If you prefer to use pip_, you can install beets with the following command: If you prefer to use pip_, you can install beets with the following command:
.. code-block:: console .. code-block:: console
@ -32,14 +35,6 @@ If you prefer to use pip_, you can install beets with the following command:
# or, to install for the current user only: # or, to install for the current user only:
pip install --user beets pip install --user beets
.. attention::
Python 3.13 is not officially supported yet!
If you are using Python 3.13, please be aware that it is not officially
supported yet. You may encounter issues, and we recommend using Python 3.12
or earlier until support is confirmed.
.. _pip: https://pip.pypa.io/en/ .. _pip: https://pip.pypa.io/en/
.. _pipx: https://pipx.pypa.io/stable .. _pipx: https://pipx.pypa.io/stable
@ -60,6 +55,9 @@ package manager. Here are some common options:
most recent version of beets. If you want the latest features and fixes, most recent version of beets. If you want the latest features and fixes,
consider using pipx_ or pip_ as described above. consider using pipx_ or pip_ as described above.
Additionally, installing external beets plugins may be surprisingly
difficult when using a package manager.
- On **Debian or Ubuntu**, depending on the version, beets is available as an - On **Debian or Ubuntu**, depending on the version, beets is available as an
official package (`Debian details`_, `Ubuntu details`_), so try typing: official package (`Debian details`_, `Ubuntu details`_), so try typing:
``apt-get install beets``. But the version in the repositories might lag ``apt-get install beets``. But the version in the repositories might lag
@ -84,6 +82,8 @@ package manager. Here are some common options:
- On **Solus**, run ``eopkg install beets``. - On **Solus**, run ``eopkg install beets``.
- On **NixOS**, there's a `package <nixos_>`_ you can install with ``nix-env -i - On **NixOS**, there's a `package <nixos_>`_ you can install with ``nix-env -i
beets``. beets``.
- Using **MacPorts**, run ``port install beets`` or ``port install beets-full``
to include many third-party plugins.
.. _alpine package: https://pkgs.alpinelinux.org/package/edge/community/x86_64/beets .. _alpine package: https://pkgs.alpinelinux.org/package/edge/community/x86_64/beets

2
docs/index.rst
View file

@ -22,8 +22,6 @@ tracker. Please let us know where you think this documentation can be improved.
.. _the discussion board: https://github.com/beetbox/beets/discussions/ .. _the discussion board: https://github.com/beetbox/beets/discussions/
.. _the mailing list: https://groups.google.com/group/beets-users
Contents Contents
-------- --------