2022-07-01 09:02:29 +00:00
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2022, The Funkwhale Collective
# This file is distributed under the same license as the funkwhale package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
2022-07-23 13:32:35 +00:00
"Project-Id-Version: funkwhale 1.2.7\n"
2022-07-01 09:02:29 +00:00
"Report-Msgid-Bugs-To: \n"
2022-07-23 13:32:35 +00:00
"POT-Creation-Date: 2022-07-23 12:18+0200\n"
2022-07-01 09:02:29 +00:00
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ../../administrator_documentation/import_docs/index.md:1
msgid "Import music from your server"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:3
msgid "You can import music files you have saved on your server. You need to make sure your files have the [required ID3 tags](../../user_documentation/libraries/tag_music.md). We recommend using [Musicbrainz Picard](https://picard.musicbrainz.org/) for tagging."
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:5
msgid "Funkwhale supports the following import methods:"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:7
msgid "Copy (default) – Funkwhale copies files from your server into the media store."
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:8
msgid "In-place import – Funkwhale adds the storage location of your files to the database. This uses less space than the copy method and ensures your collection is always up-to-date."
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:10
msgid "To see a full list of options, run the command with the `--help` flag."
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
msgid "Debian"
msgstr ""
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
#: ../../administrator_documentation/import_docs/index.md:0
msgid "Docker"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:37
2022-07-01 09:02:29 +00:00
msgid "Get demo music"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:39
2022-07-01 09:02:29 +00:00
msgid "If you don't have music on your server, you can download creative commons music to test imports with. The Funkwhale project provides a collection courtesy of [Jamendo](https://jamendo.com). To download these tracks:"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:41
2022-07-01 09:02:29 +00:00
msgid "Download the shell script."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:47
2022-07-01 09:02:29 +00:00
msgid "Download the music list."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:53
2022-07-01 09:02:29 +00:00
msgid "Run the shell script against the music list to download the tracks."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:59
2022-07-01 09:02:29 +00:00
msgid "This downloads a set compressed albums to your `data/music` directory and unzips them. You can then import these tracks using the methods in this article."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:61
2022-07-01 09:02:29 +00:00
msgid "Find your library ID"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:63
2022-07-01 09:02:29 +00:00
msgid "You need to create a library before you can import music. Follow the instructions in [Create a library](../../user_documentation/libraries/create_library.md) to get started."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:65
2022-07-01 09:02:29 +00:00
msgid "Once you've created your library, you can find its ID by following these steps:"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:67
2022-07-01 09:02:29 +00:00
msgid "Visit `https://<yourdomain>/content/libraries/` in your browser. This page contains a list of your libraries."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:68
2022-07-01 09:02:29 +00:00
msgid "Find the library you want to upload content into. Select {guilabel}`Library details` to open the library details page."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:69
2022-07-01 09:02:29 +00:00
msgid "Your library's ID is the long string of letters and numbers shown in the URL bar. Copy the content before the first hyphen (`-`)."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:71
2022-07-01 09:02:29 +00:00
msgid "For example, if your library ID is `769a2bc3-eb1d-4aff-9f84-2c4d80d5c2d1`, copy the `769a2bc3`. You can use this as a shorthand reference for your library."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:73
2022-07-01 09:02:29 +00:00
msgid "Import your music"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:75
2022-07-01 09:02:29 +00:00
msgid "Copy files from your server"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:77
2022-07-01 09:02:29 +00:00
msgid "Once you have your library ID, you can copy content from your server and import it into the library. To do this:"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:79
#: ../../administrator_documentation/import_docs/index.md:162
2022-07-01 09:02:29 +00:00
msgid "Log in to your server and navigate to your Funkwhale directory."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:85
#: ../../administrator_documentation/import_docs/index.md:169
2022-07-01 09:02:29 +00:00
msgid "Export your library ID to reference it later. In this example, the library ID is \"769a2bc3\". Replace this with your library ID."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:91
2022-07-01 09:02:29 +00:00
msgid "Run the `import_files` command to copy your files. In this example, the music is stored in `data/music`. Replace this with your music directory."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:97
2022-07-01 09:02:29 +00:00
msgid "Funkwhale copies your files to your media store."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:99
2022-07-01 09:02:29 +00:00
msgid "Access your files in-place"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:101
2022-07-01 09:02:29 +00:00
msgid "The in-place import method references your files in their current directory. This is useful if you have limited storage space."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:103
2022-07-01 09:02:29 +00:00
msgid "Link your file directory"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:105
2022-07-01 09:02:29 +00:00
msgid "We recommend you symbolically link your music directories to `/srv/funkwhale/data/music`. You can then run the `import_files` command from that directory. This means you can use many directories without needing to add to them to your webserver."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:113
2022-07-01 09:02:29 +00:00
msgid "To link your storage directory to the Funkwhale store, use the `ln -s` command. For example, if you have an NFS share at `/media/nfsshare`, you can link it to a folder like this:"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:119
#: ../../administrator_documentation/import_docs/index.md:148
2022-07-01 09:02:29 +00:00
msgid "You can then run the `import_files` command against `/srv/funkwhale/data/music/nfsshare`."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:126
2022-07-01 09:02:29 +00:00
msgid "On a Docker install you can use bind mounts to reference your storage directory. To do this, you need to add the directory to the `api` and `celeryworker` blocks in your `docker-compose.yml` file. For example, if you have an NFS share at `/media/nfsshare`, you can add the following to your `docker-compose.yml` file:"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:152
2022-07-01 09:02:29 +00:00
msgid "Import your files"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:154
2022-07-01 09:02:29 +00:00
msgid "To use the in-place import method, follow these steps:"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:168
2022-07-01 09:02:29 +00:00
msgid "Add your storage location to your `.env` file if you don't want to link it to the Funkwhale store. See the [in-place import configuration variables](../configuration_docs/env_file.md#in-place-import-configuration) for more information."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:175
2022-07-03 14:13:58 +00:00
msgid "Run your import command against your music storage directory. In this example, the storage directory is `/srv/funkwhale/data/music/nfsshare`. Replace this with your storage directory."
2022-07-01 09:02:29 +00:00
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:181
#: ../../administrator_documentation/import_docs/index.md:195
2022-07-01 09:02:29 +00:00
msgid "Funkwhale imports the music in your storage directory into the specified library."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:188
2022-07-01 09:02:29 +00:00
msgid "Add your storage location to your `.env` file if you don't want to bind it to the Funkwhale store. See the [in-place import configuration variables](../configuration_docs/env_file.md#in-place-import-configuration) for more information."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:189
2022-07-03 14:13:58 +00:00
msgid "Run your import command against your music storage directory:"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:199
2022-07-01 09:02:29 +00:00
msgid "Album art"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:201
2022-07-01 09:02:29 +00:00
msgid "Funkwhale attempts to import album art for your music library. The import process checks for the following."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:203
2022-07-01 09:02:29 +00:00
msgid "The cover embedded in the audio files (works with FLAC and MP3 files)."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:204
2022-07-01 09:02:29 +00:00
msgid "A `cover.jpg` or `cover.png` in the the track's directory."
msgstr ""
2022-07-03 14:13:58 +00:00
#: ../../administrator_documentation/import_docs/index.md:205
2022-07-23 13:32:35 +00:00
msgid "An `mbid` in the file's tags. If there is an `mbid`, the import process tries to fetch cover art from Musicbrainz."
2022-07-01 09:02:29 +00:00
msgstr ""
2022-07-03 14:13:58 +00:00
#: ../../administrator_documentation/import_docs/index.md:207
2022-07-23 13:32:35 +00:00
msgid "Watch for filesystem changes"
2022-07-01 09:02:29 +00:00
msgstr ""
2022-07-03 14:13:58 +00:00
#: ../../administrator_documentation/import_docs/index.md:209
2022-07-23 13:32:35 +00:00
msgid "You can run the `import_files` command any time you add new files or update files. For larger collections, this may not be practical. To watch for changes, run the `import_files` command with the `--watch` flag. This instructs the `import_files` command to watch for filesystem events and update your database when something changes."
2022-07-01 09:02:29 +00:00
msgstr ""
2022-07-03 14:13:58 +00:00
#: ../../administrator_documentation/import_docs/index.md:211
2022-07-23 13:32:35 +00:00
msgid "The `--watch` flag performs the following actions when it detects a change:"
2022-07-01 09:02:29 +00:00
msgstr ""
2022-07-03 14:13:58 +00:00
#: ../../administrator_documentation/import_docs/index.md:213
2022-07-23 13:32:35 +00:00
msgid "File created – imports the track."
2022-07-01 09:02:29 +00:00
msgstr ""
2022-07-03 14:13:58 +00:00
#: ../../administrator_documentation/import_docs/index.md:214
2022-07-23 13:32:35 +00:00
msgid "File moved – updates the location of the track in the database."
2022-07-01 09:02:29 +00:00
msgstr ""
2022-07-03 14:13:58 +00:00
#: ../../administrator_documentation/import_docs/index.md:215
2022-07-23 13:32:35 +00:00
msgid "File metadata updated – updates the track metadata in the database."
2022-07-01 09:02:29 +00:00
msgstr ""
2022-07-03 14:13:58 +00:00
#: ../../administrator_documentation/import_docs/index.md:216
2022-07-23 13:32:35 +00:00
msgid "File deleted – removes the file from the database."
2022-07-01 09:02:29 +00:00
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:259
2022-07-01 09:02:29 +00:00
msgid "Prune dangling metadata"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:261
2022-07-01 09:02:29 +00:00
msgid "Funkwhale doesn't delete track metadata when you delete a track. This is useful if you want to delete a file but keep a record of a track for created playlists or favorites."
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:263
2022-07-01 09:02:29 +00:00
msgid "If you want to remove the file's metadata when you delete the file, run `import_files` with the `--prune` flag. This flag removes the metadata of any"
msgstr ""
2022-07-23 13:32:35 +00:00
#: ../../administrator_documentation/import_docs/index.md:266
2022-07-01 09:02:29 +00:00
msgid "You can use the `--prune` flag with the `--watch` flag. This means Funkwhale removes the metadata of referenced files you delete from your storage."
msgstr ""