Package: render-svg-icons
render-svg-iconsis a python script for rendering SVG icons to PNG icons in various sizes. While it runs on both Linux and macOS, it currently uses a specific SVG template and a folder structure based onthe XDG Icon Theme Specification.ProvenanceI've come across the progenitor of this script in multiple places. It seems to have originated with GNOME, but it's not entirely clear.Development Statusrender-svg-iconsshouldbasically work for its original purpose of rendering XDG icon themes. I plan to continue adapting the code to make it easier to use and to allow for more flexible use cases in the future.While I plan to leave the command-line interface more or less intact, it and the implementation thereof shouldn't be considered stable at the moment. If you plan to callrender-svg-iconsas a dependency, you should specify an exact version you know to work for your purposes.InstallationFor day-to-day use, you should installrender-svg-iconsfrom PyPI:$pipinstallrender-svg-iconsFor development purposes, you can build and installrender-svg-iconsfrom the cloned repository usingPoetry.To install Poetry, run:$curl-sSLhttps://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py|python-Then, from therender-svg-iconscloned repository, run:$poetrybuild
$pipinstall--force-reinstalldist/*.whlThis will install the repository code in the same manner as the PyPI version. (The--force-reinstallcauses it to overwrite any other installed version.)To uninstall either version ofrender-svg-icons, run:$pipuninstallrender-svg-iconsDependenciesrender-svg-iconsrequires bothInkscapeandOptiPNG.LinuxTo install Inkscape and OptiPNG on, e.g., Debian, Ubuntu, etc.:$sudoaptinstallinkscapeoptipng(For Fedora, Arch, etc., I'm sure you know what you're doing.)macOSTo install Inkscape and OptiPNG on macOS, first installHomebrewif you haven't already:%/bin/bash-c"$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"Then use Homebrew to install Inkscape and OptiPNG:% brew install inkscape optipngYou can probably use other installation methods, but you may need to specify the executable path if it's different from the one used by Homebrew.Other Platformsrender-svg-iconsisn't currently compatible with platforms other than Linux and macOS. If you'd like to use this on another platform, pleaseopen an issueora pull request.UsageAfter installation:$render_svg_icons--help

┌──────────────────────────────────────────────────┐
│RendericonsfromSVGtoPNG│
└──────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────┐
│Usage│
├──────────────────────────────────────────────────┤
│$render_svg_icons│
│[--help]│
│[--base_dpiBASE_DPI]│
│[--categories[CATEGORIES]]│
│[--filterFILTER]│
│[--inkscape_pathINKSCAPE_PATH]│
│[--individual_icons[INDIVIDUAL_ICONS]]│
│[--optipng_pathOPTIPNG_PATH]│
│[--output_pathOUTPUT_PATH]│
│[--scaling_factors[SCALING_FACTORS]]│
│[--verbose]│
││
└──────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────┐
│OptionalArguments│
├──────────────────────────────────────────────────┤
│--help│
││
│Showthishelpmessageandexit.│
││
│--base_dpiBASE_DPI│
││
│dpitouseforrendering(bydefault96)│
││
│--categories[CATEGORIES]│
││
│categoriesoficonstorender(bydefaultall)│
││
│--filterFILTER│
││
│Inkscapefiltertoapplywhilerendering│
│(bydefaultnone)│
││
│--inkscape_pathINKSCAPE_PATH│
││
│pathofInkscapeexecutable│
│(ifthescriptcan't find it)                  ││                                                  ││ --individual_icons [INDIVIDUAL_ICONS]            ││                                                  ││   individual icon names (without extensions)     ││   to render (by default all)                     ││                                                  ││ --optipng_path OPTIPNG_PATH                      ││                                                  ││   path of OptiPNG executable                     ││   (if the script can'tfindit)│
││
│--output_pathOUTPUT_PATH│
││
│outputdirectory(bydefault'.')│
││
│--scaling_factors[SCALING_FACTORS]│
││
│scalingfactorstorenderat│
│(bydefault[1,2],e.g.100%&200%)│
││
│--verbose│
││
│printverboseoutputtotheterminal│
││
└──────────────────────────────────────────────────┘Licenserender-svg-iconsis published under the GPLv3 or later (i.e. you can use it for proprietary purposes via the command line, but you can only link to it from other GPL code).