fergalmoran/picard
1
0
Fork 0
mirror of https://github.com/fergalmoran/picard.git synced 2026-01-05 16:13:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Extend the README

Browse Source 
Clarify the structure, add features and additional links
This commit is contained in:
Philipp Wolfer
2021-04-30 17:02:09 +02:00
parent fec882f196
commit 4e9dbc1843
1 changed files with 37 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
README.md
View File

@@ -1,24 +1,50 @@
MusicBrainz Picard
==================
# MusicBrainz Picard
![Github Actions Status](https://github.com/metabrainz/picard/workflows/Run%20tests/badge.svg)
[![Codacy Grade](https://img.shields.io/codacy/grade/4dcabf0a13ed4b27b3a381ce9ba96ecc/master.svg?style=flat-square&label=Codacy)](https://app.codacy.com/gh/metabrainz/picard)
[MusicBrainz Picard](http://picard.musicbrainz.org) is a cross-platform (Linux, macOS, Windows) application written in Python and is the official [MusicBrainz](http://musicbrainz.org) tagger.
[MusicBrainz Picard](http://picard.musicbrainz.org) is a cross-platform (Linux, macOS, Windows) audio tagging application. It is the official [MusicBrainz](http://musicbrainz.org) tagger.
Picard supports the majority of audio file formats, is capable of using audio fingerprints ([AcoustIDs](http://musicbrainz.org/doc/AcoustID)), performing CD lookups and [disc ID](http://musicbrainz.org/doc/Disc_ID) submissions, and it has excellent Unicode support. Additionally, there are several plugins available that extend Picard's features.
When tagging files, Picard uses an album-oriented approach. This approach allows it to utilize the MusicBrainz data as effectively as possible and correctly tag your music. For more information, [see the illustrated quick start guide to tagging](https://picard.musicbrainz.org/quick-start/).
When tagging files, Picard uses an album-oriented approach. This approach allows it to utilize the MusicBrainz data as effectively as possible and correctly tag your music. For more information, [see the illustrated quick start guide to tagging](https://picard.musicbrainz.org/quick-start/) and the [documentation](https://picard-docs.musicbrainz.org/).
Picard is named after Captain Jean-Luc Picard from the TV series Star Trek: The Next Generation.
Binary downloads are available [here](http://picard.musicbrainz.org/downloads/).
## Features
Support and issue reporting
---------------------------
- **Multiple formats:** Picard supports all popular music formats,
including MP3, FLAC, OGG, M4A, WMA, WAV, and more.
- **AcoustID:** Picard uses [AcoustID](http://musicbrainz.org/doc/AcoustID)
audio fingerprints, allowing files to be identified by the actual
music, even if they have no metadata.
- **Comprehensive database:** Picard uses the open and
community-maintained [MusicBrainz database](http://musicbrainz.org)
to provide accurate information about millions of music releases.
- **CD lookups:** Picard can lookup entire music CDs with a click.
- **Plugin support:** If you need a particular feature, you can choose
from a selection of available plugins or write your own.
- **Scripting:** A flexible and powerful, yet easy to learn, scripting language
allows you to exactly specify how your music files will be named and how the
tags will look like.
- **Cover Art:** Picard can find and download the correct cover art for your albums.
- **Open Source:** Picard is licensed under the
[GNU General Public License 2.0](COPYING.txt)
or later, and is hosted on GitHub where it is actively
developed.
## Installation
Binary downloads are available on the [Picard download page](http://picard.musicbrainz.org/downloads/).
[INSTALL.md has instructions on building this codebase.](INSTALL.md)
## Support and issue reporting
Please report all bugs and feature requests in the [MusicBrainz issue tracker](https://tickets.metabrainz.org/browse/PICARD). If you need support in using Picard please read the [documentation](https://picard-docs.musicbrainz.org/) first and have a look at the [MusicBrainz community forums](https://community.metabrainz.org/c/picard).
Installing
---------------------------
[INSTALL.md has instructions on building this codebase.](INSTALL.md)
## Trivia
Picard is named after Captain Jean-Luc Picard from the TV series Star Trek: The Next Generation.