funkwhale/docs/administrator/manage-script/create-library.md

Create a library

Use the create command to create new libraries for a given user.

:header-rows: 1

* - Parameter
   - Data type
   - Description

* - `username`*
   - String
   - The user you want to create the library for.

* - `--name`
   - String
   - The name of the library. Defaults to "default".

* - `--privacy-level`
   - Enum (String)
   - The [privacy level](../../user/libraries/create.md) of the library
      - `"me"` (default)
      - `"instance"`
      - `"everyone"`

Examples

Create a new library

Use the following command to create a new library with a custom name and privacy level.

::::{tab-set}

:::{tab-item} Debian :sync: debian

venv/bin/funkwhale-manage create username1 --name="Library 1" --privacy-level="everyone"

:::

:::{tab-item} Docker :sync: docker

sudo docker compose run --rm api funkwhale-manage create username1 --name="Library 1" --privacy-level="everyone"

:::

::::

Returns

Created library Library 1 for user username1 with UUID 436da05b-8cb1-4a4d-b870-4a3b235d8517

Create a new library with no name or privacy level

You can create a library using only a username. The script substitutes default values for the library name and privacy level.

::::{tab-set}

:::{tab-item} Debian :sync: debian

venv/bin/funkwhale-manage create username1

:::

:::{tab-item} Docker :sync: docker

sudo docker compose run --rm api funkwhale-manage create username1

:::

::::

Returns

Created library default for user username1 with UUID 436da05b-8cb1-4a4d-b870-4a3b235d8517

Library with the same name already exists

If a library with the same name already exists for the given user, the script will not create a new library.

::::{tab-set}

:::{tab-item} Debian :sync: debian

venv/bin/funkwhale-manage create username1 --name="Library 1" --privacy-level="everyone"

:::

:::{tab-item} Docker :sync: docker

sudo docker compose run --rm api funkwhale-manage create username1 --name="Library 1" --privacy-level="everyone"

:::

::::

Returns

Found existing library Library 1 for user username1 with UUID 436da05b-8cb1-4a4d-b870-4a3b235d8517