From ceab08a26dee947d86ca406c2b385950372ce3ce Mon Sep 17 00:00:00 2001 From: blue Date: Sat, 6 Jul 2024 13:53:26 -0300 Subject: [PATCH] Typo fixes, readme updates --- CHANGELOG.md | 5 +++- CMakeLists.txt | 4 +-- README.md | 50 +++++++++++++++++++++++++++++++----- cmake/FindTAGLIB.cmake | 4 +-- packaging/Archlinux/PKGBUILD | 2 +- src/default.conf | 20 +++++++-------- src/help | 16 ++++++------ src/logger/logger.cpp | 6 ++--- src/logger/logger.h | 2 +- src/logger/printer.cpp | 4 +-- src/settings.cpp | 6 ++--- 11 files changed, 80 insertions(+), 39 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index baa5c37..9fbc7bd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,8 @@ # Changelog +## MLC 1.3.4 (UNRELEASED) +- Build fixes + ## MLC 1.3.3 (October 13, 2023) - Regex to specify non-music files to copy - Encoding settings (VBR/CBR, encoding quality, output quality) @@ -23,7 +26,7 @@ ## MLC 1.1.0 (July 23, 2023) - New logging system -- Artist, Album artist, Album and Title are now utf16 encoded, should fix broten titles +- Artist, Album artist, Album and Title are now utf16 encoded, should fix broken titles - BPM tag is now rounded, as it supposed to be by spec - Lyrics is not set now for USLT tag for unsychronized lyrics is not supported in LAME - Date bug fix, it was MMDD instead of standard DDMM diff --git a/CMakeLists.txt b/CMakeLists.txt index cd5a172..0c5aa2a 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -1,8 +1,8 @@ cmake_minimum_required(VERSION 3.5) project( mlc - VERSION 1.3.3 - DESCRIPTION "Media Library Compiler: rips your media library to a lossy compilation" + VERSION 1.3.4 + DESCRIPTION "Media Library Compiler: converts your media library to a lossy compilation" LANGUAGES CXX ) cmake_policy(SET CMP0076 NEW) diff --git a/README.md b/README.md index 8d3f250..4beaa8b 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,8 @@ # MLC - Music Library Compiler -This is a program for compilation of your loseless music library to lossy formats +[![AUR version](https://img.shields.io/aur/version/mlc?style=flat-square)](https://aur.archlinux.org/packages/mlc/) + +This is a program to compile your local lossless music library to lossy formats ### Prerequisites @@ -11,7 +13,7 @@ This is a program for compilation of your loseless music library to lossy format ### Building -``` +```sh $ git clone https://git.macaw.me/blue/mlc $ cd mlc $ mkdir build @@ -22,12 +24,48 @@ $ cmake --build . ### Usage +Just to compile lossless library to lossy you can use this command +assuming you are in the same directory you have just built `MLC`: + ``` -./mlc path/to/loseless/library path/to/store/lossy/library +./mlc path/to/lossless/library path/to/store/lossy/library ``` -For now the program is very primitive, it only works to convert `.flac` files (it trusts the suffix) to `.mp3` VBR best possible quality slowest possible conversion algorithm. +There are more ways to use `MLC`, please refer to help for more options: -MLC keeps file structure, copies all the non `.flac` files, tries to adapt some `.flac` (vorbis) tags to id3v1 and id3v2 of destination `.mp3` file. +```sh +$ ./mlc help +# or +$ ./mlc --help +# +# or +$ ./mlc -h +``` -For now it's siglethread, no interrupt controll, not even sure converted files are valid, no exotic cases handled, no conversion options can be passed. May be will improve in the futer. +`MLC` has a way to configure conversion process, it will generate global for you user config on the first launch. +It will be located in `~/.config/mlc.conf` and `MLC` will notify you when it's generated. + +You can also make local configs for each directory you launch mlc from. + +To output the default config run the following, assuming you are in the same directory you have just built `MLC`: + +```sh +$ ./mlc config +``` + +To use non default config run the following, assuming you are in the same directory you have just built `MLC`: + +```sh +$ ./mlc path/to/lossless/library path/to/store/lossy/library -c path/to/config/file +``` + +### About + +For now the program is very primitive, it only works to convert `.flac` files (it trusts the suffix) to `.mp3`. +I'm planing to add more lossy formats first then, may be, more lossless. + +`MLC` keeps file structure, copies all the non `.flac` files, tries to adapt some `.flac` (vorbis) tags to id3v1 and id3v2 of destination `.mp3` file. +You can set up output format and quality and which kind of files should it skip in the config. + +By default `MLC` runs on as many threads as your system can provide to speed up conversion process. +You can set up correct amount of threads in the config. diff --git a/cmake/FindTAGLIB.cmake b/cmake/FindTAGLIB.cmake index b4e2b2b..1ec7b1c 100644 --- a/cmake/FindTAGLIB.cmake +++ b/cmake/FindTAGLIB.cmake @@ -9,11 +9,11 @@ if(TAGLIB_FOUND) add_library(TAGLIB::TAGLIB SHARED IMPORTED) set_target_properties(TAGLIB::TAGLIB PROPERTIES IMPORTED_LOCATION "${TAGLIB_LIBRARIES}" - INTERFACE_INCLUDE_DIRECTORIES "${FLAC_INCLUDE_DIR}/taglib" + INTERFACE_INCLUDE_DIRECTORIES "${TAGLIB_INCLUDE_DIR}/taglib" INTERFACE_LINK_LIBRARIES "${TAGLIB_LIBRARIES}" ) if (NOT TAGLIB_FIND_QUIETLY) - message(STATUS "Found TAGLIB includes: ${FLAC_INCLUDE_DIR}/taglib") + message(STATUS "Found TAGLIB includes: ${TAGLIB_INCLUDE_DIR}/taglib") message(STATUS "Found TAGLIB library: ${TAGLIB_LIBRARIES}") endif () else() diff --git a/packaging/Archlinux/PKGBUILD b/packaging/Archlinux/PKGBUILD index 266d3ae..93a9aef 100644 --- a/packaging/Archlinux/PKGBUILD +++ b/packaging/Archlinux/PKGBUILD @@ -1,6 +1,6 @@ # Maintainer: Yury Gubich pkgname=mlc -pkgver=1.3.3 +pkgver=1.3.4 pkgrel=1 pkgdesc="Media Library Compiler: rips your media library to a lossy compilation" arch=('i686' 'x86_64') diff --git a/src/default.conf b/src/default.conf index 68f329a..d7ef46d 100644 --- a/src/default.conf +++ b/src/default.conf @@ -5,12 +5,12 @@ # # Use # sign for comments # -# All printed comented out values are default values +# All printed commented out values are default values # # You should have one of this files as ~/.config/mlc.conf, # if you have started mlc at least once. # This is going to be used every time you launch mlc, -# so, edit it if you wish to change default behaviour. +# so, edit it if you wish to change default behavior. # # Alternatively, you can launch `mlc -c customConfig.conf` # if you wish to override ~/.config/mlc.conf file @@ -20,26 +20,26 @@ #level info # Output type -# Allowed values are: [mp3] (more comming soon) +# Allowed values are: [mp3] (more coming soon) #type mp3 # Source collection path # This is a default path to your music collection source. -# It's usefull to set it when you always encode the same collection +# It's useful to set it when you always encode the same collection # Leaving this empty (as it is by default) will make you always # specify source in the command line #source -# Destingation path +# Destination path # This is a default path for your encoding destination -# It's usefull to set it when you often encode your collection +# It's useful to set it when you often encode your collection # to the same output # Leaving this empty (as it is by default) will make you always # specify destination in the command line #destination # Parallel tasks -# Defines how many threads are going to be started in parralel +# Defines how many threads are going to be started in parallel # Allowed values are [0, 1, 2, 3 ...] etc # If it's set to 0 - amount of threads is going to be # as high as your processor can effectively handle @@ -62,9 +62,9 @@ # Output quality # Sets up output quality -# The higher quality the less information is lonst in compression +# The higher quality the less information is lost in compression # 0 is the highest possible quality for selected mode and type and results in the biggest file -# 9 is the lowest quality but results in the smalest file +# 9 is the lowest quality but results in the smallest file # Allowed values are [0, 1, 2, ... 9] # For the constant bitrate modes (CBR) the following table is valid # Quality | MP3 | @@ -94,5 +94,5 @@ # Switches on or off variable bitrate # VBR files are usually smaller, but not supped to be worse # in terms of quality. VBR files might be a bit more tricky for the player -# Allowedvalues are: [true, false] +# Allowed values are: [true, false] #vbr true diff --git a/src/help b/src/help index 34356f5..622aba1 100644 --- a/src/help +++ b/src/help @@ -20,23 +20,23 @@ Flags: - sets action to help, and prints this page Examples: - `mlc ~/Music comile/latest` + `mlc ~/Music compile/latest` - reads config file from `~/.config/mlc.conf` - if there was not - creates default that changes nothing - - creates directory `conpile` in the CURRENT directory if it was not created before - - create `latest` directory in `compile` dirrectory if it was not created before + - creates directory `compile` in the CURRENT directory if it was not created before + - create `latest` directory in `compile` directory if it was not created before - searches for music in `~/Music` directory - - converts all music to `comile/latest` directory - - copies all other files found in `~/Music` to `comile/latest` - - any file name overlap will be overriden + - converts all music to `compile/latest` directory + - copies all other files found in `~/Music` to `compile/latest` + - any file name overlap will be overridden `mlc config > myConfig.conf` - prints default config to standard output - unix operator `>` redirects output to a file `myConfig.conf` - `mlc rip -c myConfig.conf` + `mlc convert -c myConfig.conf` - reads file `myConfig.conf` from current directory - if `myConfig.conf` has a valid `source` entry - uses it and uses `rip` as destination - if `myConfig.conf` has a valid `destination` entry - uses it and uses `rip` as source - - if both present (don't do this way) - it depends on the order, who comes first - defines behaviour + - if both present (don't do this way) - it depends on the order, who comes first - defines behavior - the rest is the same from the first example apart from default config diff --git a/src/logger/logger.cpp b/src/logger/logger.cpp index 9be0ef6..35780ee 100644 --- a/src/logger/logger.cpp +++ b/src/logger/logger.cpp @@ -4,7 +4,7 @@ #include #include -constexpr std::array(Logger::Severity::_sevetirySize)> levels({ +constexpr std::array(Logger::Severity::_severitySize)> levels({ "debug", "info", "minor", @@ -46,8 +46,8 @@ void Logger::fatal(const std::string& comment, bool colored) const { Logger::Severity Logger::stringToSeverity(const std::string& line) { unsigned char dist = std::distance(levels.begin(), std::find(levels.begin(), levels.end(), line)); - if (dist < static_cast(Severity::_sevetirySize)) + if (dist < static_cast(Severity::_severitySize)) return static_cast(dist); - return Severity::_sevetirySize; + return Severity::_severitySize; } diff --git a/src/logger/logger.h b/src/logger/logger.h index 65b00c7..6608f50 100644 --- a/src/logger/logger.h +++ b/src/logger/logger.h @@ -13,7 +13,7 @@ public: warning, error, fatal, - _sevetirySize + _severitySize }; using Message = std::pair; diff --git a/src/logger/printer.cpp b/src/logger/printer.cpp index 8c1f49c..5040fa2 100644 --- a/src/logger/printer.cpp +++ b/src/logger/printer.cpp @@ -4,7 +4,7 @@ #include #include -constexpr const std::array(Logger::Severity::_sevetirySize)> logSettings({ +constexpr const std::array(Logger::Severity::_severitySize)> logSettings({ /*debug*/ "\e[90m", /*info*/ "\e[32m", /*minor*/ "\e[34m", @@ -14,7 +14,7 @@ constexpr const std::array(Logger::Severity:: /*fatal*/ "\e[91m" }); -constexpr const std::array(Logger::Severity::_sevetirySize)> logHeaders({ +constexpr const std::array(Logger::Severity::_severitySize)> logHeaders({ /*debug*/ "DEBUG: ", /*info*/ "INFO: ", /*minor*/ "MINOR: ", diff --git a/src/settings.cpp b/src/settings.cpp index 0dabf3b..39be0a7 100644 --- a/src/settings.cpp +++ b/src/settings.cpp @@ -203,14 +203,14 @@ unsigned char Settings::getOutputQuality() const { if (outputQuality.has_value()) return outputQuality.value(); else - return minQuality; //actually, it means max possible quality + return minQuality; //it means max possible quality, min is for min enum value } unsigned char Settings::getEncodingQuality() const { if (encodingQuality.has_value()) return encodingQuality.value(); else - return minQuality; //actually, it means max possible quality + return minQuality; //it means max possible quality, min is for min enum value } bool Settings::getVBR() const { @@ -269,7 +269,7 @@ void Settings::readConfigLine(const std::string& line) { std::string lv; if (!logLevel.has_value() && stream >> lv) { Logger::Severity level = Logger::stringToSeverity(lv); - if (level < Logger::Severity::_sevetirySize) + if (level < Logger::Severity::_severitySize) logLevel = level; } } break;