ite 0.5.3

Command line ID3 tag editor
.TH ite 1 2025/7/7 Ite\ 0.5.0 Ite\ Manual
.SH NAME
Ite — command line ID3 tag editor

.SH SYNOPSIS
\fBite\fR [\fB--help\fR|\fB-h\fR|\fBhelp\fR] \fIcommand ...\fR

.SH DESCRIPTION
Ite, a most venerable tag editor, is constructed upon the illustrious Rust \fBid3\fR library, which may be graciously accessed at \fBhttps://crates.io/crates/id3\fR. This esteemed application bestows upon its users a most gratifying experience in the artful configuration of audio tags, rendering the task both pleasurable and efficient.

The programme further avails itself of a Rust Command Line Argument Parser library, known as \fBclap\fR, which may be conveniently accessed at \fBhttps://crates.io/crates/clap\fR. This esteemed library enhances the functionality of Ite, facilitating the seamless handling of command line arguments with utmost elegance.

In addition to the aforementioned, Ite doth employ the \fBclap_complete\fR library, accessible at \fBhttps://crates.io/crates/clap_complete\fR. This distinguished library bestows upon the programme the capability of providing completions for the principal command line shells, thereby enhancing the user experience with a most refined touch.

In the esteemed construction of Ite, the venerable tag editor, the illustrious \fBtokio\fR library has been incorporated, which may be accessed at \fBhttps://crates.io/crates/tokio\fR. This remarkable library, celebrated for its asynchronous programming capabilities, bestows upon the application the ability to execute tasks efficiently. By harnessing \fBtokio\fR, Ite performs multiple operations concurrently, ensuring a fluid user experience and allowing users to configure audio tags with grace and ease.

Furthermore, the esteemed programme doth employ the venerable Rust serialising framework known as \fBserde\fR, accessible at \fBhttps://crates.io/crates/serde\fR. This distinguished library, celebrated for its mastery in data serialisation, grants Ite the ability to manage data structures with remarkable finesse. In concert with this, the programme doth incorporate the \fBtoml\fR library, found at \fBhttps://crates.io/crates/toml\fR, which serves as a proficient tool for parsing configurations in the TOML format. Thus, through the union of \fBserde\fR and \fBtoml\fR, Ite ensures that user preferences are seamlessly integrated, enhancing the overall experience of this venerable tag editor.

At the time of composing this document, Ite doth possess the esteemed capability to reveal the presence of any native ID3v2.4.0 tag frame within an input audio file. It proficiently displays the contents of the ‘Comments’, ‘Synchronised Lyrics/Text’, ‘Text Information Frames’, ‘Unsynchronised Lyrics/Text Transcription’ and ‘URL Link Frames’ through the command \fBprint\fR. Furthermore, it graciously provides the user with the means to access the cover art of an audio file via the command \fBget\fR. 

In addition, Ite facilitates the removal of metadata, a task that is executed with effortless ease by the command \fBremove\fR. Lastly, one may set the attached picture and the text frames with the assistance of \fBset\fR. Moreover, one is afforded the opportunity to generate a completion script for the programme using the command \fBcomplete\fR.

A notable advantage of Ite lies in its capacity to permit, in addition to the manual specification of a singular frame, the utilisation of compilations. This feature enables the output and deletion of a diverse array of frames with each interaction. Furthermore, it graciously allows the user to select whether to provide input as text or as a path, a functionality that likewise operates in the reverse direction, thereby enhancing the programme’s versatility and user-friendliness.

.SS COMMANDS
\fBcomplete\fR
.RS 4
The most expeditious means of alleviating the burden of excessive typing. Kindly refer to \fBite-complete\fR(1) for further elucidation.  
.RE

\fBget\fR
.RS 4
A most uncomplicated method for accessing the contents of a singular tag frame. I beseech You to consult \fBite-get\fR(1) for further guidance.
.RE

\fBprint\fR
.RS 4
A utility designed for the output of audio tag metadata; the elder sibling of \fBget\fR. I entreat You to refer to \fBite-print\fR(1) for additional information.
.RE

\fBremove\fR
.RS 4
A means for the deletion of audio metadata; I humbly beseech You to consult \fBite-remove\fR(1) for further elucidation.
.RE

\fBset\fR
.RS 4
An effective instrument when one desires manual content assignment; I beseech You to consult \fBite-set\fR(1) for further enlightenment.
.RE

.SH SEE ALSO
\fBite-configuration\fR(7)