Skip to content

Commit 7ae8b9c

Browse files
authored
Merge pull request #4069 from catap/macports-note
Added notes about MacPorts
2 parents fcd90bf + 6da853e commit 7ae8b9c

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

docs/guides/main.rst

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,10 @@ You will need Python.
1313
Beets works on Python 3.6 or later.
1414

1515
* **macOS** 11 (Big Sur) includes Python 3.8 out of the box.
16-
You can opt for a more recent Python installing it via `Homebrew`_:
17-
``brew install python3``
16+
You can opt for a more recent Python installing it via `Homebrew`_
17+
(``brew install python3``).
18+
There's also a `MacPorts`_ port. Run ``port install beets`` or
19+
``port install beets-full`` to include many third-party plugins.
1820

1921
* On **Debian or Ubuntu**, depending on the version, beets is available as an
2022
official package (`Debian details`_, `Ubuntu details`_), so try typing:
@@ -55,6 +57,7 @@ Beets works on Python 3.6 or later.
5557
.. _OpenBSD: http://openports.se/audio/beets
5658
.. _Arch community: https://www.archlinux.org/packages/community/any/beets/
5759
.. _NixOS: https://github.com/NixOS/nixpkgs/tree/master/pkgs/tools/audio/beets
60+
.. _MacPorts: https://www.macports.org
5861

5962
If you have `pip`_, just say ``pip install beets`` (or ``pip install --user
6063
beets`` if you run into permissions problems).
@@ -71,14 +74,14 @@ new versions.
7174

7275
.. _@b33ts: https://twitter.com/b33ts
7376

74-
Installing on macOS 10.11 and Higher
75-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
77+
Installing by Hand on macOS 10.11 and Higher
78+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
7679

7780
Starting with version 10.11 (El Capitan), macOS has a new security feature
7881
called `System Integrity Protection`_ (SIP) that prevents you from modifying
79-
some parts of the system. This means that some ``pip`` commands may fail with
80-
a permissions error. (You probably *won't* run into this if you've installed
81-
Python yourself with `Homebrew`_ or otherwise.)
82+
some parts of the system. This means that some ``pip`` commands may fail with a
83+
permissions error. (You probably *won't* run into this if you've installed
84+
Python yourself with `Homebrew`_ or otherwise. You can also try `MacPorts`_.)
8285

8386
If this happens, you can install beets for the current user only by typing
8487
``pip install --user beets``. If you do that, you might want to add

0 commit comments

Comments
 (0)