nicole.1.man

@@ -1,7 +1,9 @@
-.\" Automatically generated by Pandoc 3.1.8
+.\" Automatically generated by Pandoc 2.17.0.1
 .\"
-.TH "NICOLE" "1" "May 2024" "nicole 2.1.0" ""
+.TH "NICOLE" "1" "April 2022" "nicole 2.0" ""
+.hy
 .SH NAME
+.PP
 \f[B]N\f[R]ew-\f[B]I\f[R]ntrepid-\f[B]C\f[R]hief-\f[B]O\f[R]f-\f[B]L\f[R]yrics-\f[B]E\f[R]mbedders
 (obviously)
 .PP
@@ -25,6 +27,7 @@ File:
 \ \ \ \f[B]nicole\f[R] [OPTION\&...]
 -f FILE
 .SS Files
+.PP
 Nicole supports FLAC and mp3 files.
 Other files can not be edited (as of now).
 Files that do not have a .flac or .mp3 extension are skipped
@@ -36,24 +39,26 @@ automatically.
 \f[B]flac\f[R]: lyrics are stored as vorbis-comment with key
 \[lq]LYRICS\[rq]
 .SS History
+.PP
 Nicole creates a history of all files that were processed in
-\f[CR]\[ti]/.configs/nicole\f[R].
+\f[C]\[ti]/.configs/nicole\f[R].
-If a file is in the history, it will be skipped (unless \f[CR]-i\f[R] is
+If a file is in the history, it will be skipped (unless \f[C]-i\f[R] is
 passed).
 If the lyrics for a file can not be obtained, it is added to
-\f[CR]\[ti]/.configs/nicole/failed_files\f[R].
+\f[C]\[ti]/.configs/nicole/failed_files\f[R].
 Those files are not skipped, the file only exists so that you can see
 which lyrics were not downloaded.
 .PP
-If you don\[cq]t want your files in the history, add the \f[CR]-n\f[R]
+If you don\[cq]t want your files in the history, add the \f[C]-n\f[R]
 option.
 .SS genius
+.PP
 Nicole searches for lyrics using the genius api with the \[lq]title\[rq]
 and \[lq]artist\[rq] tags of the file.
-If the title and artist names from genius are similar enough to the ones
+If the title and artist names from genius and the tags are similar, the
-of the file, the lyrics are scraped from the url obtained through the
+lyrics are scraped from the url obtained through the api.
-api.
 .SS azlyrics
+.PP
 Nicole creates an azlyrics.com url from the \[lq]title\[rq] and
 \[lq]artist\[rq] tags of the file.
 The lyrics are extracted from the html document using regex.
@@ -61,74 +66,92 @@ The lyrics are extracted from the html document using regex.
 Unfortunately, there needs to be a 5 second delay between each request
 to azlyrics.com because the site will block your ip for a while if you
 send many requests.
+.SS Important Note
+.PP
+Since the lyrics are extracted from html pages and not from an api, the
+lyrics sites might temporarily block your ip address if you send too
+many requests.
+If that is the case, wait a few hours and try again.
 .SH USAGE
 .SS Command line options
 .TP
-\f[B]\[em]-directory\f[R], \f[B]-d\f[R] directory
+\f[B]-d\f[R] directory
 process directory [directory]
 .TP
-\f[B]\[em]-file\f[R], \f[B]-f\f[R] file
+\f[B]-f\f[R] file
 process file [file]
 .TP
-\f[B]\[em]-recursive\f[R], \f[B]-r\f[R]
+\f[B]-r\f[R]
 go through directories recursively
 .TP
-\f[B]\[em]-silent\f[R]
+\f[B]-s\f[R]
 silent, no command-line output
 .TP
-\f[B]\[em]-ignore-history\f[R], \f[B]-i\f[R]
+\f[B]-i\f[R]
 ignore history
 .TP
-\f[B]\[em]-no-history\f[R], \f[B]-n\f[R]
+\f[B]-n\f[R]
 do not write to history
 .TP
-\f[B]\[em]-overwrite\f[R], \f[B]-o\f[R]
+\f[B]-o\f[R]
 overwrite if the file already has lyrics
 .TP
-\f[B]\[em]-test\f[R], \f[B]-t\f[R]
+\f[B]-t\f[R]
 test, do not write lyrics to file, but print to stdout
 .TP
-\f[B]\[em]-rm-explicit\f[R]
+\f[B]-h\f[R]
+show this
+.TP
+\f[B]\[em]-rm_explicit\f[R]
 remove the \[lq][Explicit]\[rq] lyrics warning from the song\[cq]s title
 tag
 .TP
-\f[B]\[em]-site\f[R], \f[B]-s\f[R] site
+\f[B]\[em]-site\f[R] site
 onlysearch [site] for lyrics (genius or azlyrics)
 .PP
-One of \f[CR]----file\f[R] and \f[CR]--directory\f[R] must be given at
+If you do not specify a directory or file, the program will ask you if
-least once.
+you want to use the current working directory.
-Example: \f[CR]nicole -ior -d \[ti]/music/artist ----rm-explicit\f[R]
+Example: \f[C]nicole -ior -d \[ti]/music/artist ----rm_explicit\f[R]
 .SH INSTALLATION AND UPDATING
+.PP
 To update nicole, simply follow the installation instructions.
 .SS pacman (Arch Linux)
+.PP
 Installing nicole using the Arch Build System also installs the man-page
 and a zsh completion script, if you have zsh installed.
 .IP
-.EX
+.nf
+\f[C]
 git clone https://github.com/MatthiasQuintern/nicole.git
 cd nicole
 makepkg -si
-.EE
+\f[R]
+.fi
 .SS pip
+.PP
 You can also install nicole with python-pip:
 .IP
-.EX
+.nf
+\f[C]
 git clone https://github.com/MatthiasQuintern/nicole.git
 cd nicole
 python3 -m pip install .
-.EE
+\f[R]
+.fi
 .PP
 You can also install it system-wide using
-\f[CR]sudo python3 -m pip install.\f[R]
+\f[C]sudo python3 -m pip install.\f[R]
 .PP
 If you also want to install the man-page and the zsh completion script:
 .IP
-.EX
+.nf
+\f[C]
 sudo cp nicole.1.man /usr/share/man/man1/nicole.1
 sudo gzip /usr/share/man/man1/nicole.1
 sudo cp _nicole.compdef.zsh /usr/share/zsh/site-functions/_nicole
 sudo chmod +x /usr/share/zsh/site-functions/_nicole
-.EE
+\f[R]
+.fi
 .SS Dependencies
 .IP \[bu] 2
 https://github.com/quodlibet/mutagen read and write mp3-tags
@@ -139,24 +162,9 @@ genius
 The dependencies will be automatically installed when using the either
 of the two installation options.
 .SH CHANGELOG
-.SS 2.1.0
-.IP \[bu] 2
-Refactoring:
-.RS 2
-.IP \[bu] 2
-use argparse
-.IP \[bu] 2
-use pyproject.toml
-.RE
-.IP \[bu] 2
-Ignore case when matching a genius result
 .SS 2.0
 .IP \[bu] 2
 Nicole now supports lyrics from genius!
-.IP \[bu] 2
-Added man-page
-.IP \[bu] 2
-Added zsh-completion
 .SS 1.1
 .IP \[bu] 2
 Lyrics are now properly encoded.
@@ -166,7 +174,8 @@ be checked.
 .IP \[bu] 2
 Files are now processed in order
 .SH COPYRIGHT
-Copyright © 2024 Matthias Quintern.
+.PP
+Copyright \[co] 2022 Matthias Quintern.
 License GPLv3+: GNU GPL version 3 <https://gnu.org/licenses/gpl.html>.
 .PD 0
 .P

pyproject.toml

@@ -1,34 +1,23 @@
 [build-system]
-requires = ["setuptools"]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
 
-[project]
+[tool.setuptools]
 name = "nicole"
 version = "2.1.0"
 description = "Write lyrics from genius or azlyrics.com into a mp3-tag"
-authors = [ 
+author = "Matthias Quintern"
-    { name = "Matthias Quintern", email = "matthias.quintern@posteo.de" }
+author_email = "matthias.quintern@posteo.de"
-]
+url = "https://github.com/MatthiasQuintern/nicole.git"
-requires-python = ">=3.7"
+license = "GPLv3"
+packages = ["nicole"]
+install_requires = ["mutagen", "beautifulsoup4"]
 
-license = { file = "LICENSE" }
+[tool.setuptools.entry-points]
-dependencies = [
+console_scripts = ["nicole=nicole.nicole:main"]
-    "mutagen",
-    "beautifulsoup4"
-]
 
-classifiers = [
+[tool.setuptools.metadata]
-    "Operating System :: POSIX :: Linux",
+description-file = "readme.md"
-    "Environment :: Console",
-    "Programming Language :: Python :: 3",
-    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
-]
-
-[project.urls]
-repository = "https://github.com/MatthiasQuintern/nicole.git"
-
-[project.scripts]
-nicole = "nicole.nicole:main"
 
 [tool.setuptools.packages.find]
-where = ["."]
+where = "."
-

readme.md

@@ -10,7 +10,7 @@ Files that do not have a .flac or .mp3 extension are skipped automatically.
 - mp3: lyrics are stored in "USLT" tag as "lyrics-   "
 - flac: lyrics are stored as vorbis-comment with key "LYRICS"
 
-## History
+### History
 Nicole creates a history of all files that were processed in `~/.configs/nicole`.
 If a file is in the history, it will be skipped (unless `-i` is passed).
 If the lyrics for a file can not be obtained, it is added to `~/.configs/nicole/failed_files`.
@@ -18,35 +18,37 @@ Those files are not skipped, the file only exists so that you can see which lyri
 
 If you don't want your files in the history, add the `-n` option.
 
-## genius
+### genius
 Nicole searches for lyrics using the genius api with the "title" and "artist" tags of the file.
-If the title and artist names from genius are similar enough to the ones of the file,
+If the title and artist names from genius and the tags are similar, the lyrics are scraped from the url obtained through the api.
-the lyrics are scraped from the url obtained through the api.
 
-## azlyrics
+### azlyrics
 Nicole creates an azlyrics.com url from the "title" and "artist" tags of the file.
 The lyrics are extracted from the html document using regex.
 
-Unfortunately, there needs to be a 5 second delay between each request to azlyrics.com because 
+Unfortunately, there needs to be a 5 second delay between each request to azlyrics.com because the site will block your ip for a while if you send many requests.
-the site will block your ip for a while if you send many requests.
+
+### Important Note
+Since the lyrics are extracted from html pages and not from an api, the lyrics sites might temporarily block your ip address if you send too many requests.
+If that is the case, wait a few hours and try again.
 
 ## Usage
 
 ### Command line options
-- `--directory DIRECTORY, -d DIRECTORY`
+- `-d [directory]` process directory [directory]
-                          process directory [directory]
+- `-f [file]` process file [file]
-- `--file FILE, -f FILE`  process file [file]
+- `-r` go through directories recursively
-- `--recursive, -r`       go through directories recursively
+- `-s` silent, no command-line output
-- `--silent`              silent, no command-line output
+- `-i` ignore history
-- `--ignore-history, -i`  ignore history
+- `-n` do not write to history
-- `--no-history, -n`      do not write to history
+- `-o` overwrite if the file already has lyrics
-- `--overwrite, -o`       overwrite if the file already has lyrics
+- `-t` test, do not write lyrics to file, but print to stdout
-- `--dry-run, -t`         test, do not write lyrics to file, but print to console
+- `-h` show this
-- `--rm-explicit`         remove the "[Explicit]" lyrics warning from the songs title tag
+- `--rm_explicit` remove the "[Explicit]" lyrics warning from the song's title tag
-- `--site SITE, -s SITE`  use only [site]: azlyrics or genius
+- `--site [site]` only search [site] for lyrics (genius or azlyrics)
 
-
+If you do not specify a directory or file, the program will ask you if you want to use the current working directory.
-Example: `nicole -ior -d ~/music/artist --rm-explicit`
+Example: `nicole -ior -d ~/music/artist --rm_explicit`
 
 ## Installation and Updating
 To update nicole, simply follow the installation instructions.
@@ -83,12 +85,6 @@ sudo chmod +x /usr/share/zsh/site-functions/_nicole
 The dependencies will be automatically installed when using the either of the two installation options.
 
 ## Changelog
-## 2.1.0
-- Refactoring:
-    - use argparse
-    - use pyproject.toml
-- Ignore case when matching a genius result
-
 ### 2.0
 - Nicole now supports lyrics from genius!
 - Added man-page
@@ -100,5 +96,5 @@ The dependencies will be automatically installed when using the either of the tw
 - Files are now processed in order
 
 # Copyright
-Copyright  ©  2024  Matthias  Quintern.  License GPLv3+: GNU GPL version 3 <https://gnu.org/licenses/gpl.html>.\
+Copyright  ©  2022  Matthias  Quintern.  License GPLv3+: GNU GPL version 3 <https://gnu.org/licenses/gpl.html>.\
 This is free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent permitted by law.

setup.py

@@ -0,0 +1,30 @@
+from setuptools import setup
+
+setup(
+        name="nicole",
+        version="2.1.0",
+        description="Write lyrics from genius or azlyrics.com to a mp3-tag",
+
+        author="Matthias Quintern",
+        author_email="matthiasqui@protonmail.com",
+
+        url="https://github.com/MatthiasQuintern/nicole.git",
+
+        license="GPLv3",
+
+        packages=["nicole"],
+        install_requires=["mutagen", "beautifulsoup4"],
+
+        classifiers=[
+            "Operating System :: POSIX :: Linux",
+            "Environment :: Console",
+            "Programming Language :: Python :: 3",
+            "Topic :: Multimedia :: Audio",
+            "Topic :: Utilities",
+            ],
+
+        # scripts=["bin/nicole"],
+        entry_points={
+            "console_scripts": [ "nicole=nicole.nicole:main" ],
+            },
+)