diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index ee963ab466..44d6cdca78 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -63,28 +63,25 @@ Programming
 Development Tools
 +++++++++++++++++
 
-In order to develop beets, you will need a few tools installed:
+In order to develop beets, you will need a few tools installed on your system:
 
 - poetry_ for packaging, virtual environment and dependency management
 - poethepoet_ to run tasks, such as linting, formatting, testing
+- pre-commit_ to automatically run formatting tasks before each commit.
 
-Python community recommends using pipx_ to install stand-alone command-line
-applications such as above. pipx_ installs each application in an isolated
-virtual environment, where its dependencies will not interfere with your system
-and other CLI tools.
+You can install these tools using your distribution's package management system,
+but if you want to use the latest available releases, the Python community
+recommends using pipx_ to install stand-alone command-line applications such as
+above. pipx_ installs each application in an isolated virtual environment, where
+its dependencies will not interfere with your system and other CLI tools.
 
-If you do not have pipx_ installed in your system, follow `pipx installation
-instructions <https://pipx.pypa.io/stable/installation/>`__ or
-
-.. code-block:: sh
-
-    $ python3 -m pip install --user pipx
-
-Install poetry_ and poethepoet_ using pipx_:
+If you do not have pipx_ installed in your system, follow the `pipx installation
+instructions <https://pipx.pypa.io/stable/installation/>`__, then install
+poetry_, poethepoet_ and pre-commit_ using pipx_:
 
 ::
 
-    $ pipx install poetry poethepoet
+    $ pipx install poetry poethepoet pre-commit
 
 .. admonition:: Check ``tool.pipx-install`` section in ``pyproject.toml`` to see supported versions
 
@@ -120,18 +117,28 @@ with ``poetry run`` to them, for example ``poetry run pytest``.
 On the other hand, it may get tedious to type ``poetry run`` before every
 command. Instead, you can activate the virtual environment in your shell with:
 
+::
+
+    $ eval $(poetry env activate)
+
+(this will work for Bash/Zsh/Csh; for other shells, see the `poetry
+documentation`_)
+
+Another way to activate the environment is by using the `shell poetry plugin
+<https://github.com/python-poetry/poetry-plugin-shell>`__ and running:
+
 ::
 
     $ poetry shell
 
-You should see ``(beets-py3.9)`` prefix in your shell prompt. Now you can run
-commands directly, for example:
+You should now see the ``(beets-py3.9)`` prefix in your shell prompt. Now you
+can run commands directly, for example:
 
 ::
 
     $ (beets-py3.9) pytest
 
-Additionally, poethepoet_ task runner assists us with the most common
+Additionally, the poethepoet_ task runner assists us with the most common
 operations. Formatting, linting, testing are defined as ``poe`` tasks in
 pyproject.toml_. Run:
 
@@ -150,6 +157,15 @@ to see all available tasks. They can be used like this, for example
     $ poe test --lf             # re-run failing tests (note the additional pytest option)
     $ poe check-types --pretty  # check types with an extra option for mypy
 
+Finally, pre-commit_ helps us to automatically run some poe tasks before each
+commit, for example to fix formatting issues in code and documentation files.
+You just have to activate pre-commit in your git working copy by running
+``pre-commit install`` (the beets source tree already contains a configuration
+file for pre-commit). You can learn more about pre-commit `here
+<https://pre-commit.com/>`_.
+
+.. _poetry documentation: https://python-poetry.org/docs/managing-environments/#activating-the-environment
+
 Code Contribution Ideas
 +++++++++++++++++++++++
 
@@ -161,12 +177,12 @@ Code Contribution Ideas
   is somewhat low. You can help out by finding low-coverage modules or checking
   out other `testing-related issues
   <https://github.com/beetbox/beets/labels/testing>`__.
-- There are several ways to improve the tests in general (see :ref:`testing` and
-  some places to think about performance optimization (see `Optimization
+- There are several ways to improve the tests in general (see :ref:`testing`)
+  and some places to think about performance optimization (see `Optimization
   <https://github.com/beetbox/beets/wiki/Optimization>`__).
 - Not all of our code is up to our coding conventions. In particular, the
   `library API documentation
-  <https://beets.readthedocs.io/en/stable/dev/library.html>`__ are currently
+  <https://beets.readthedocs.io/en/stable/dev/library.html>`__ is currently
   quite sparse. You can help by adding to the docstrings in the code and to the
   documentation pages themselves. beets follows `PEP-257
   <https://www.python.org/dev/peps/pep-0257/>`__ for docstrings and in some
@@ -179,8 +195,8 @@ Your First Contribution
 
 If this is your first time contributing to an open source project, welcome! If
 you are confused at all about how to contribute or what to contribute, take a
-look at `this great tutorial <http://makeapullrequest.com/>`__, or stop by our
-`discussion board`_ if you have any questions.
+look at `this great tutorial`_ or stop by our `discussion board`_ if you have
+any questions.
 
 We maintain a list of issues we reserved for those new to open source labeled
 `first timers only`_. Since the goal of these issues is to get users comfortable
@@ -189,6 +205,8 @@ questions.
 
 .. _first timers only: https://github.com/beetbox/beets/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22
 
+.. _this great tutorial: https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github
+
 How to Submit Your Work
 -----------------------
 
@@ -196,19 +214,18 @@ Do you have a great bug fix, new feature, or documentation expansion you’d lik
 to contribute? Follow these steps to create a GitHub pull request and your code
 will ship in no time.
 
-1. Fork the beets repository and clone it (see above) to create a workspace.
-2. Install pre-commit, following the instructions `here
-   <https://pre-commit.com/>`_.
-3. Make your changes.
-4. Add tests. If you’ve fixed a bug, write a test to ensure that you’ve actually
+1. Fork the beets repository, clone it and install the development tools
+   following the instructions above.
+2. Make your changes.
+3. Add tests. If you’ve fixed a bug, write a test to ensure that you’ve actually
    fixed it. If there’s a new feature or plugin, please contribute tests that
    show that your code does what it says.
-5. Add documentation. If you’ve added a new command flag, for example, find the
+4. Add documentation. If you’ve added a new command flag, for example, find the
    appropriate page under ``docs/`` where it needs to be listed.
-6. Add a changelog entry to ``docs/changelog.rst`` near the top of the document.
-7. Run the tests and style checker, see :ref:`testing`.
-8. Push to your fork and open a pull request! We’ll be in touch shortly.
-9. If you add commits to a pull request, please add a comment or re-request a
+5. Add a changelog entry to ``docs/changelog.rst`` near the top of the document.
+6. Run the tests and style checker, see :ref:`testing`.
+7. Push to your fork and open a pull request! We’ll be in touch shortly.
+8. If you add commits to a pull request, please add a comment or re-request a
    review after you push them since GitHub doesn’t automatically notify us when
    commits are added.
 
@@ -292,15 +309,15 @@ Handling Paths
 A great deal of convention deals with the handling of **paths**. Paths are
 stored internally—in the database, for instance—as byte strings (i.e., ``bytes``
 instead of ``str`` in Python 3). This is because POSIX operating systems’ path
-names are only reliably usable as byte strings—operating systems typically
+names are only reliably usable as byte strings; operating systems typically
 recommend but do not require that filenames use a given encoding, so violations
 of any reported encoding are inevitable. On Windows, the strings are always
 encoded with UTF-8; on Unix, the encoding is controlled by the filesystem. Here
 are some guidelines to follow:
 
 - If you have a Unicode path or you’re not sure whether something is Unicode or
-  not, pass it through ``bytestring_path`` function in the ``beets.util`` module
-  to convert it to bytes.
+  not, pass it through the ``bytestring_path`` function in the ``beets.util``
+  module to convert it to bytes.
 - Pass every path name through the ``syspath`` function (also in ``beets.util``)
   before sending it to any *operating system* file operation (``open``, for
   example). This is necessary to use long filenames (which, maddeningly, must be
@@ -314,17 +331,25 @@ are some guidelines to follow:
 Editor Settings
 ~~~~~~~~~~~~~~~
 
-Personally, I work on beets with vim_. Here are some ``.vimrc`` lines that might
-help with PEP 8-compliant Python coding:
+Personally, I work on beets with vim_. To get a nice python working environment
+in vim, be sure to include the following lines in your ``.vimrc``:
 
 ::
 
-    filetype indent on
-    autocmd FileType python setlocal shiftwidth=4 tabstop=4 softtabstop=4 expandtab shiftround autoindent
+    syntax on
+    filetype plugin indent on
 
-Consider installing `this alternative Python indentation plugin
-<https://github.com/mitsuhiko/vim-python-combined>`__. I also like `neomake
-<https://github.com/neomake/neomake>`__ with its flake8 checker.
+This will turn on syntax highlighting and load the standard vim filetype plugin
+for python files (with proper settings for indentation etc).
+
+Here's a few vim plugins that you might find useful to improve your vim python
+experience:
+
+- `neomake <https://github.com/neomake/neomake>`__, with its flake8 checker.
+- `vim-flake8 <https://github.com/nvie/vim-flake8>`__, another interface to
+  flake8.
+- `VOoM outliner <https://www.vim.org/scripts/script.php?script_id=2657>`__, can
+  help to navigate big python files.
 
 .. _testing:
 
@@ -416,6 +441,8 @@ This way, the test will be run only in the integration test suite.
 
 .. _poetry: https://python-poetry.org/docs/
 
+.. _pre-commit: https://pre-commit.com/
+
 .. _pyproject.toml: https://github.com/beetbox/beets/tree/master/pyproject.toml
 
 .. _pytest: https://docs.pytest.org/en/stable/
diff --git a/README.rst b/README.rst
index 3d5a847122..93d5b21e99 100644
--- a/README.rst
+++ b/README.rst
@@ -90,15 +90,19 @@ simple if you know a little Python.
 Install
 -------
 
-You can install beets by typing ``pip install beets`` or directly from Github
-(see details here_). Beets has also been packaged in the `software
-repositories`_ of several distributions. Check out the `Getting Started`_ guide
-for more information.
+Beets has been packaged in the `software repositories`_ of several
+distributions, or is also installable via pipx_. Check out the `Getting
+Started`_ guide for more information.
+
+If you want to install the very latest source code from Github, see the
+instructions here_.
 
 .. _getting started: https://beets.readthedocs.org/page/guides/main.html
 
 .. _here: https://beets.readthedocs.io/en/latest/faq.html#run-the-latest-source-version-of-beets
 
+.. _pipx: https://pipx.pypa.io/stable
+
 .. _software repositories: https://repology.org/project/beets/versions
 
 Contribute
diff --git a/docs/faq.rst b/docs/faq.rst
index 718356e424..76aca91397 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -112,7 +112,13 @@ together different versions of the same album. Use *release* IDs here.
 …upgrade to the latest version of beets?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Run a command like this:
+If you installed beets with pipx_, just run:
+
+::
+
+    pipx upgrade beets
+
+If you installed beets with pip_, just run:
 
 ::
 
@@ -133,29 +139,25 @@ specific version, you can specify with using ``==`` like so:
 Beets sees regular releases (about every six weeks or so), but sometimes it's
 helpful to run on the "bleeding edge". To run the latest source:
 
-1. Uninstall beets. If you installed using ``pip``, you can just run ``pip
-   uninstall beets``.
+1. Uninstall beets using the tools in your distribution, or, if you installed
+   using ``pip``, just run ``pip uninstall beets``. If you used ``pipx``, just
+   run ``pipx uninstall beets``.
+
 2. Install from source. Choose one of these methods:
 
-   - Directly from GitHub using ``python -m pip install
-     git+https://github.com/beetbox/beets.git`` command. Depending on your
-     system, you may need to use ``pip3`` and ``python3`` instead of ``pip`` and
-     ``python`` respectively.
-   - Use ``pip`` to install the latest snapshot tarball. Type: ``pip install
-     https://github.com/beetbox/beets/tarball/master``
-   - Use ``pip`` to install an "editable" version of beets based on an automatic
-     source checkout. For example, run ``pip install -e
-     git+https://github.com/beetbox/beets#egg=beets`` to clone beets and install
-     it, allowing you to modify the source in-place to try out changes.
-   - Clone source code and install it in editable mode
+   - Use ``pipx`` to install directly from GitHub.
+     Run: ``pipx install git+https://github.com/beetbox/beets.git``.
 
-     .. code-block:: shell
+   - Use ``pipx`` to install the latest snapshot tarball. Run:
+     ``pipx install https://github.com/beetbox/beets/tarball/master``
 
-         git clone https://github.com/beetbox/beets.git
-         poetry install
+If you'd like to make local changes to your beets installation, you can install
+an "editable" version, using the ``-e`` option of pipx, for example:
+``pipx install -e git+https://github.com/beetbox/beets.git``.
 
-     This approach lets you decide where the source is stored, with any changes
-     immediately reflected in your environment.
+If you'd also like to contribute to the development of beets, the best way to
+install the source code is detailed in the :doc:`contributing </contributing>`
+page.
 
 More details about the beets source are available on the :doc:`developer
 documentation </dev/index>` pages.
@@ -367,4 +369,6 @@ try `this Super User answer`_.
 
 .. _pip: https://pip.pypa.io/en/stable/
 
+.. _pipx: https://pipx.pypa.io/en/stable/
+
 .. _this super user answer: https://superuser.com/a/284361/4569
diff --git a/docs/guides/main.rst b/docs/guides/main.rst
index 0b502bfb13..02bc7dd162 100644
--- a/docs/guides/main.rst
+++ b/docs/guides/main.rst
@@ -19,8 +19,8 @@ You will need Python. Beets works on Python 3.8 or later.
   official package (`Debian details`_, `Ubuntu details`_), so try typing:
   ``apt-get install beets``. But the version in the repositories might lag
   behind, so make sure you read the right version of these docs. If you want the
-  latest version, you can get everything you need to install with pip as
-  described below by running: ``apt-get install python-dev python-pip``
+  latest version, you can get everything you need to install with pipx as
+  described below by running: ``apt-get install pipx``
 - On **Arch Linux**, `beets is in [extra] <arch extra_>`_, so just run ``pacman
   -S beets``. (There's also a bleeding-edge `dev package <aur_>`_ in the AUR,
   which will probably set your computer on fire.)
@@ -65,19 +65,16 @@ You will need Python. Beets works on Python 3.8 or later.
 
 .. _void package: https://github.com/void-linux/void-packages/tree/master/srcpkgs/beets
 
-If you have pip_, just say ``pip install beets`` (or ``pip install --user
-beets`` if you run into permissions problems).
+If your distribution doesn't still ship the latest regular release of beets, you
+can install it via pipx_ in a dedicated python virtual environment, which won't
+interfere with other python packages provided by your distribution. Just
+`install pipx <https://pipx.pypa.io/stable/installation/>`__ and run ``pipx
+install beets``.
 
-To install without pip, download beets from `its PyPI page`_ and run ``python
-setup.py install`` in the directory therein.
+.. _pipx: https://pipx.pypa.io/stable
 
-.. _its pypi page: https://pypi.org/project/beets/#files
-
-.. _pip: https://pip.pypa.io
-
-The best way to upgrade beets to a new version is by running ``pip install -U
-beets``. You may want to follow `@b33ts`_ on Twitter to hear about progress on
-new versions.
+To upgrade beets to a new version, just run ``pipx upgrade beets``. You may want
+to follow `@b33ts`_ on Twitter to hear about progress on new versions.
 
 .. _@b33ts: https://twitter.com/b33ts
 
diff --git a/docs/plugins/absubmit.rst b/docs/plugins/absubmit.rst
index 262977c4fb..5572281f81 100644
--- a/docs/plugins/absubmit.rst
+++ b/docs/plugins/absubmit.rst
@@ -23,7 +23,7 @@ the AcousticBrainz FAQ_).
 
 Then, install ``beets`` with ``absubmit`` extra
 
-    pip install "beets[absubmit]"
+    pipx install "beets[absubmit]"
 
 Lastly, enable the plugin in your configuration (see :ref:`using-plugins`).
 
diff --git a/docs/plugins/aura.rst b/docs/plugins/aura.rst
index a29fa19521..721f52ece6 100644
--- a/docs/plugins/aura.rst
+++ b/docs/plugins/aura.rst
@@ -16,7 +16,7 @@ Install
 To use the ``aura`` plugin, first enable it in your configuration (see
 :ref:`using-plugins`). Then, install ``beets`` with ``aura`` extra
 
-    pip install "beets[aura]"
+    pipx install "beets[aura]"
 
 Usage
 -----
diff --git a/docs/plugins/autobpm.rst b/docs/plugins/autobpm.rst
index 00f02d6a8a..aa81101846 100644
--- a/docs/plugins/autobpm.rst
+++ b/docs/plugins/autobpm.rst
@@ -14,7 +14,7 @@ To use the ``autobpm`` plugin, first enable it in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[autobpm]"
+    pipx install "beets[autobpm]"
 
 Configuration
 -------------
diff --git a/docs/plugins/beatport.rst b/docs/plugins/beatport.rst
index 4e7569a1b4..c3d34b70b2 100644
--- a/docs/plugins/beatport.rst
+++ b/docs/plugins/beatport.rst
@@ -16,7 +16,7 @@ To use the ``beatport`` plugin, first enable it in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[beatport]"
+    pipx install "beets[beatport]"
 
 You will also need to register for a Beatport_ account. The first time you run
 the :ref:`import-cmd` command after enabling the plugin, it will ask you to
diff --git a/docs/plugins/bpd.rst b/docs/plugins/bpd.rst
index dc0bd92b27..406108e2e2 100644
--- a/docs/plugins/bpd.rst
+++ b/docs/plugins/bpd.rst
@@ -33,7 +33,7 @@ extra which installs Python bindings for ``GStreamer``:
 
 .. code-block:: console
 
-    pip install "beets[bpd]"
+    pipx install "beets[bpd]"
 
 .. _gstreamer: https://gstreamer.freedesktop.org/download
 
diff --git a/docs/plugins/chroma.rst b/docs/plugins/chroma.rst
index 4e333ab99c..9fc81f9426 100644
--- a/docs/plugins/chroma.rst
+++ b/docs/plugins/chroma.rst
@@ -31,7 +31,7 @@ To get fingerprinting working, you'll need to install three things:
 
 .. code-block:: bash
 
-    pip install "beets[chroma]"
+    pipx install "beets[chroma]"
 
 2. the Chromaprint_ library_ or |command-line-tool|_
 3. an |audio-decoder|_
diff --git a/docs/plugins/discogs.rst b/docs/plugins/discogs.rst
index 44c0c0e220..6a1c094fa9 100644
--- a/docs/plugins/discogs.rst
+++ b/docs/plugins/discogs.rst
@@ -19,7 +19,7 @@ To use the ``discogs`` plugin, first enable it in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[discogs]"
+    pipx install "beets[discogs]"
 
 You will also need to register for a Discogs_ account, and provide
 authentication credentials via a personal access token or an OAuth2
diff --git a/docs/plugins/embedart.rst b/docs/plugins/embedart.rst
index abbe2460d2..170e9f6062 100644
--- a/docs/plugins/embedart.rst
+++ b/docs/plugins/embedart.rst
@@ -15,7 +15,7 @@ To use the ``embedart`` plugin, first enable it in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[embedart]"
+    pipx install "beets[embedart]"
 
 You'll also want to enable the :doc:`/plugins/fetchart` to obtain the images to
 be embedded. Art will be embedded after each album has its cover art set.
diff --git a/docs/plugins/embyupdate.rst b/docs/plugins/embyupdate.rst
index 5bb69cca0b..c5d2b2091a 100644
--- a/docs/plugins/embyupdate.rst
+++ b/docs/plugins/embyupdate.rst
@@ -9,7 +9,7 @@ install ``beets`` with ``embyupdate`` extra
 
 .. code-block:: bash
 
-    pip install "beets[embyupdate]"
+    pipx install "beets[embyupdate]"
 
 Then, you'll want to configure the specifics of your Emby server. You can do
 that using an ``emby`` section in your ``config.yaml``
diff --git a/docs/plugins/fetchart.rst b/docs/plugins/fetchart.rst
index 1d64f4b2e9..4f6d028fbf 100644
--- a/docs/plugins/fetchart.rst
+++ b/docs/plugins/fetchart.rst
@@ -9,7 +9,7 @@ To use the ``fetchart`` plugin, first enable it in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[fetchart]"
+    pipx install "beets[fetchart]"
 
 Fetching Album Art During Import
 --------------------------------
diff --git a/docs/plugins/index.rst b/docs/plugins/index.rst
index 960ecfbef2..c386c06223 100644
--- a/docs/plugins/index.rst
+++ b/docs/plugins/index.rst
@@ -34,13 +34,36 @@ its name:
     convert:
         auto: true
 
-Some plugins have special dependencies that you'll need to install. The
-documentation page for each plugin will list them in the setup instructions. For
-some, you can use ``pip``'s "extras" feature to install the dependencies:
+Some plugins have special dependencies that you'll need to install. For some,
+you can just use ``pipx``'s "extras" feature to install the dependencies while
+installing beets.
+
+For example, this will install beets and all the python packages required by the
+fetchart, lyrics, and lastgenre "extras" (plugins):
 
 .. code-block:: sh
 
-    pip install "beets[fetchart,lyrics,lastgenre]"
+    pipx install "beets[fetchart,lyrics,lastgenre]"
+
+If you have already installed beets, you can install the extra dependencies in
+one of the following ways:
+
+- If you installed beets via ``pipx``, just run: ``pipx install -f
+  "beets[fetchart,lyrics,lastgenre]"`` Or, if you already know which python
+  packages are needed by the extra/plugin, you can install them running: ``pipx
+  inject beets package1 package2 package3``
+- If you installed beets via ``pip``, just run ``pip install
+  "beets[fetchart,lyrics,lastgenre]"``
+- If you installed beets via your distribution's package manager, you should
+  identify and install the python packages needed by each "extra" feature. You
+  can learn about that in the documentation page for each plugin, in your
+  distribution's package management system (sometimes they are listed as
+  optional/suggested dependencies for the beets package), or in the
+  ``pyproject.toml`` file in the beets sources.
+
+Some plugins need further components to be installed and/or more configuration
+changes, we recommend reading the documentation page for each plugin for
+detailed setup instructions.
 
 .. _metadata-source-plugin-configuration:
 
diff --git a/docs/plugins/kodiupdate.rst b/docs/plugins/kodiupdate.rst
index 20bc38b0fd..be51be67bc 100644
--- a/docs/plugins/kodiupdate.rst
+++ b/docs/plugins/kodiupdate.rst
@@ -36,7 +36,7 @@ To use the ``kodiupdate`` plugin, first enable it in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[kodiupdate]"
+    pipx install "beets[kodiupdate]"
 
 You'll also need to enable JSON-RPC in Kodi.
 
diff --git a/docs/plugins/lastgenre.rst b/docs/plugins/lastgenre.rst
index 5ebe2d7213..418ef52b50 100644
--- a/docs/plugins/lastgenre.rst
+++ b/docs/plugins/lastgenre.rst
@@ -14,7 +14,7 @@ To use the ``lastgenre`` plugin, first enable it in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[lastgenre]"
+    pipx install "beets[lastgenre]"
 
 Usage
 -----
diff --git a/docs/plugins/lastimport.rst b/docs/plugins/lastimport.rst
index 61fadc506d..1dd1491937 100644
--- a/docs/plugins/lastimport.rst
+++ b/docs/plugins/lastimport.rst
@@ -16,7 +16,7 @@ To use the ``lastimport`` plugin, first enable it in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[lastimport]"
+    pipx install "beets[lastimport]"
 
 Next, add your Last.fm username to your beets configuration file:
 
diff --git a/docs/plugins/lyrics.rst b/docs/plugins/lyrics.rst
index 7984fcb6c9..f71f72b492 100644
--- a/docs/plugins/lyrics.rst
+++ b/docs/plugins/lyrics.rst
@@ -19,7 +19,7 @@ Firstly, enable ``lyrics`` plugin in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[lyrics]"
+    pipx install "beets[lyrics]"
 
 Fetch Lyrics During Import
 --------------------------
diff --git a/docs/plugins/metasync.rst b/docs/plugins/metasync.rst
index 617281c6bd..ceae9467ec 100644
--- a/docs/plugins/metasync.rst
+++ b/docs/plugins/metasync.rst
@@ -22,7 +22,7 @@ install ``beets`` with ``metasync`` extra
 
 .. code-block:: bash
 
-    pip install "beets[metasync]"
+    pipx install "beets[metasync]"
 
 .. _dbus-python: https://dbus.freedesktop.org/releases/dbus-python/
 
diff --git a/docs/plugins/mpdstats.rst b/docs/plugins/mpdstats.rst
index 276b069e3d..fa566993b9 100644
--- a/docs/plugins/mpdstats.rst
+++ b/docs/plugins/mpdstats.rst
@@ -23,7 +23,7 @@ This plugin requires the python-mpd2 library in order to talk to the MPD server.
 To use the ``mpdstats`` plugin, first enable it in your configuration (see
 :ref:`using-plugins`). Then, install ``beets`` with ``mpdstats`` extra
 
-    pip install "beets[mpdstats]"
+    pipx install "beets[mpdstats]"
 
 Usage
 -----
diff --git a/docs/plugins/plexupdate.rst b/docs/plugins/plexupdate.rst
index a3aecae113..fc311c247a 100644
--- a/docs/plugins/plexupdate.rst
+++ b/docs/plugins/plexupdate.rst
@@ -8,7 +8,7 @@ Firstly, install ``beets`` with ``plexupdate`` extra
 
 .. code-block:: console
 
-    pip install "beets[plexupdate]"
+    pipx install "beets[plexupdate]"
 
 Then, enable ``plexupdate`` plugin it in your configuration (see
 :ref:`using-plugins`). Optionally, configure the specifics of your Plex server.
diff --git a/docs/plugins/replaygain.rst b/docs/plugins/replaygain.rst
index c7e51d25d5..2b914f4c3a 100644
--- a/docs/plugins/replaygain.rst
+++ b/docs/plugins/replaygain.rst
@@ -38,7 +38,7 @@ bindings for Python
 
 .. code-block:: bash
 
-    pip install "beets[replaygain]"
+    pipx install "beets[replaygain]"
 
 Lastly, enable the ``replaygain`` plugin in your configuration (see
 :ref:`using-plugins`) and specify the GStreamer backend by adding this to your
diff --git a/docs/plugins/scrub.rst b/docs/plugins/scrub.rst
index 77e3dc6966..05118e77d1 100644
--- a/docs/plugins/scrub.rst
+++ b/docs/plugins/scrub.rst
@@ -16,7 +16,7 @@ with ``scrub`` extra
 
 .. code-block:: bash
 
-    pip install "beets[scrub]"
+    pipx install "beets[scrub]"
 
 When importing new files (with ``import.write`` turned on) or modifying files'
 tags with the ``beet modify`` command, beets will first strip all types of tags
diff --git a/docs/plugins/sonosupdate.rst b/docs/plugins/sonosupdate.rst
index 956a26a2a6..e6f175fa10 100644
--- a/docs/plugins/sonosupdate.rst
+++ b/docs/plugins/sonosupdate.rst
@@ -10,7 +10,7 @@ To use ``sonosupdate`` plugin, enable it in your configuration (see
 To use the ``sonosupdate`` plugin, first enable it in your configuration (see
 :ref:`using-plugins`). Then, install ``beets`` with ``sonosupdate`` extra
 
-    pip install "beets[sonosupdate]"
+    pipx install "beets[sonosupdate]"
 
 With that all in place, you'll see beets send the "update" command to your Sonos
 controller every time you change your beets library.
diff --git a/docs/plugins/thumbnails.rst b/docs/plugins/thumbnails.rst
index 4eeeb74be1..e61363bc56 100644
--- a/docs/plugins/thumbnails.rst
+++ b/docs/plugins/thumbnails.rst
@@ -11,7 +11,7 @@ install ``beets`` with ``thumbnails`` and ``fetchart`` extras
 
 .. code-block:: bash
 
-    pip install "beets[fetchart,thumbnails]"
+    pipx install "beets[fetchart,thumbnails]"
 
 ``thumbnails`` need to resize the covers, and therefore requires either
 ImageMagick_ or Pillow_.
diff --git a/docs/plugins/web.rst b/docs/plugins/web.rst
index 74e2cf03eb..aa8fc044dc 100644
--- a/docs/plugins/web.rst
+++ b/docs/plugins/web.rst
@@ -20,7 +20,7 @@ To use the ``web`` plugin, first enable it in your configuration (see
 
 .. code-block:: bash
 
-    pip install "beets[web]"
+    pipx install "beets[web]"
 
 Run the Server
 --------------
diff --git a/docs/reference/config.rst b/docs/reference/config.rst
index bc823ded45..1ddcfb8f18 100644
--- a/docs/reference/config.rst
+++ b/docs/reference/config.rst
@@ -619,8 +619,11 @@ necessary. Defaults to ``no``.
 
 This kind of clone is only available on certain filesystems: for example, btrfs
 and APFS. For more details on filesystem support, see the pyreflink_
-documentation. Note that you need to install ``pyreflink``, either through
-``python -m pip install beets[reflink]`` or ``python -m pip install reflink``.
+documentation. Note that you need to install ``pyreflink``, via your
+distribution's package management system, or, if you installed beets using
+``pip``, you can run ``python -m pip install beets[reflink]`` or ``python -m pip
+install reflink``; if you installed beets via ``pipx``, you can run ``pipx
+inject beets reflink``.
 
 The option is ignored if ``move`` is enabled (i.e., beets can move or copy files
 but it doesn't make sense to do both).