Skip to content

Commit 18ab4b1

Browse files
committed
Added notes about MacPorts
1 parent dd711c0 commit 18ab4b1

File tree

1 file changed

+11
-8
lines changed

1 file changed

+11
-8
lines changed

docs/guides/main.rst

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,11 @@ Installing
1212
You will need Python.
1313
Beets works on Python 3.6 or later.
1414

15-
* **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``
15+
* On **macOS**, there's a `MacPorts`_ port. macOS 11 (Big Sur) includes Python
16+
3.8 out of the box and you may install it via ``pip``. You can opt for a more
17+
recent Python installing it via `Homebrew`_: ``brew install python3`` for older
18+
versions. There's also a MacPorts port. Just run ``port install beets`` or
19+
``port install beets-full`` to install it with a lot of 3rd 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)