anifetch-cli 1.0.0__tar.gz → 1.0.2__tar.gz

{anifetch_cli-1.0.0/src/anifetch_cli.egg-info → anifetch_cli-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anifetch-cli
-Version: 1.0.0
+Version: 1.0.2
 Summary: Animated terminal fetch with video and audio support.
 Author-email: Notenlish <notenlish@gmail.com>
 Maintainer: Immelancholy
@@ -65,7 +65,12 @@ winget install chafa ffmpeg fastfetch
 
 You can install neofetch too but it is deprecated and not recommended. Run this to install: `winget install neofetch`
 
-You can then install anifetch via `pip install anifetch-cli`. You can install it via pipx too by doing: `pipx install anifetch-cli`
+After installing the necessary dependencies using winget/scoop, install anifetch via pip. You can install it via pipx too.
+
+```pip install anifetch-cli```
+
+> [!WARNING]
+> **Do not** install `anifetch` on pypi, it is not related with this project. Install `anifetch-cli`.
 
 ### Installation for MacOS with Homebrew
 
@@ -77,8 +82,12 @@ Run this in the terminal after verifying homebrew is installed:
 brew install chafa ffmpeg fastfetch
 ```
 
-You can then install anifetch via `pip install anifetch-cli`. You can install it via pipx too via `pipx install anifetch-cli`
+After installing the necessary dependencies, install anifetch via pip . You can install it via pipx too.
 
+```pip install anifetch-cli```
+
+> [!WARNING]
+> **Do not** install `anifetch` on pypi, it is not related with this project. Install `anifetch-cli`.
 
 ### Manual Installation
 
@@ -256,6 +265,12 @@ _Note : by default, the video `example.mp4` can directly be used as an example._
 - `--quality`: Changes the output quality of ffmpeg when extracting frames. This doesn't have much effect on the quality or speed from my testing, so you shouldn't need to change this. 2 highest quality, 10 lowest quality.
 - `--loop`: Determines how many times the animation should loop. Default is -1(always loop).
 - `--no-key-exit`: Don't exit anifetch when user presses a key.
+- `-c` / `--config`: Specify a non-default config for Neofetch/Fastfetch.
+  - Accepts a path or preset name (e.g. `main`).
+  - Neofetch (Linux/macOS): `~/.config/neofetch/main.conf`
+  - Fastfetch (Linux/macOS): `~/.config/fastfetch/main.jsonc`
+  - Fastfetch (Windows): `%APPDATA%\fastfetch\main.jsonc`
+  - See [Customizing Fastfetch/Neofetch](#customizing-fastfetchneofetch-output) for config details.
 
 ### Cached files:
 
@@ -309,6 +324,8 @@ As it can be seen, Anifetch is quite fast if you cache the animations.
 
 Make sure to install the dependencies listed on [Prerequisites](#Prerequisites). If ffmpeg throws an error saying `libxm12.so.16: cannot open shared object file: No such file or directory exists` then you must install `libxm12`. Here's an comment showing how to install it for arch: [https://github.com/Notenlish/anifetch/issues/24#issuecomment-2920189918](solution)
 
+If weird characters are appearing in your terminal then your terminals font probably can't render some characters. Consider installling [nerdfonts](https://www.nerdfonts.com/).
+
 ## Notes
 
 Anifetch attempts to cache the animation so that it doesn't need to render them again when you run it with the same file. However, if the name of the file is the same, but it's contents has changed, it won't re-render it. In that case, you will need to add `--force-render` as an argument to `anifetch.py` so that it re-renders it. You only have to do this only once when you change the file contents.

{anifetch_cli-1.0.0 → anifetch_cli-1.0.2}/README.md

@@ -38,7 +38,12 @@ winget install chafa ffmpeg fastfetch
 
 You can install neofetch too but it is deprecated and not recommended. Run this to install: `winget install neofetch`
 
-You can then install anifetch via `pip install anifetch-cli`. You can install it via pipx too by doing: `pipx install anifetch-cli`
+After installing the necessary dependencies using winget/scoop, install anifetch via pip. You can install it via pipx too.
+
+```pip install anifetch-cli```
+
+> [!WARNING]
+> **Do not** install `anifetch` on pypi, it is not related with this project. Install `anifetch-cli`.
 
 ### Installation for MacOS with Homebrew
 
@@ -50,8 +55,12 @@ Run this in the terminal after verifying homebrew is installed:
 brew install chafa ffmpeg fastfetch
 ```
 
-You can then install anifetch via `pip install anifetch-cli`. You can install it via pipx too via `pipx install anifetch-cli`
+After installing the necessary dependencies, install anifetch via pip . You can install it via pipx too.
 
+```pip install anifetch-cli```
+
+> [!WARNING]
+> **Do not** install `anifetch` on pypi, it is not related with this project. Install `anifetch-cli`.
 
 ### Manual Installation
 
@@ -229,6 +238,12 @@ _Note : by default, the video `example.mp4` can directly be used as an example._
 - `--quality`: Changes the output quality of ffmpeg when extracting frames. This doesn't have much effect on the quality or speed from my testing, so you shouldn't need to change this. 2 highest quality, 10 lowest quality.
 - `--loop`: Determines how many times the animation should loop. Default is -1(always loop).
 - `--no-key-exit`: Don't exit anifetch when user presses a key.
+- `-c` / `--config`: Specify a non-default config for Neofetch/Fastfetch.
+  - Accepts a path or preset name (e.g. `main`).
+  - Neofetch (Linux/macOS): `~/.config/neofetch/main.conf`
+  - Fastfetch (Linux/macOS): `~/.config/fastfetch/main.jsonc`
+  - Fastfetch (Windows): `%APPDATA%\fastfetch\main.jsonc`
+  - See [Customizing Fastfetch/Neofetch](#customizing-fastfetchneofetch-output) for config details.
 
 ### Cached files:
 
@@ -282,6 +297,8 @@ As it can be seen, Anifetch is quite fast if you cache the animations.
 
 Make sure to install the dependencies listed on [Prerequisites](#Prerequisites). If ffmpeg throws an error saying `libxm12.so.16: cannot open shared object file: No such file or directory exists` then you must install `libxm12`. Here's an comment showing how to install it for arch: [https://github.com/Notenlish/anifetch/issues/24#issuecomment-2920189918](solution)
 
+If weird characters are appearing in your terminal then your terminals font probably can't render some characters. Consider installling [nerdfonts](https://www.nerdfonts.com/).
+
 ## Notes
 
 Anifetch attempts to cache the animation so that it doesn't need to render them again when you run it with the same file. However, if the name of the file is the same, but it's contents has changed, it won't re-render it. In that case, you will need to add `--force-render` as an argument to `anifetch.py` so that it re-renders it. You only have to do this only once when you change the file contents.

{anifetch_cli-1.0.0 → anifetch_cli-1.0.2}/pyproject.toml

@@ -24,7 +24,7 @@ keywords = [
     "fastfetch",
     "anifetch",
 ]
-version = "1.0.0"
+version = "1.0.2"
 description = "Animated terminal fetch with video and audio support."
 # If I put everyone here it messes with the "author" meta section.
 authors = [{ name = "Notenlish", email = "notenlish@gmail.com" }]

{anifetch_cli-1.0.0 → anifetch_cli-1.0.2}/src/anifetch/cli.py

@@ -75,7 +75,6 @@ parser.add_argument(
     help="Disabled by default. Anifetch saves the filename to check if the file has changed, if the name is same, it won't render it again. If enabled, the video will be forcefully rendered, whether it has the same name or not. Please note that it only checks for filename, if you changed the framerate then you'll need to force render.",
 )
 parser.add_argument(
-    "-C",
     "--center",
     default=False,
     action="store_true",
@@ -123,7 +122,7 @@ parser.add_argument(
     "-nf",
     "--neofetch",
     default=False,
-    help="Add this argument if you want to use neofetch instead.",
+    help="Add this argument if you want to use neofetch instead. You may need to add --force on some linux distros too.",
     action="store_true",
 )
 parser.add_argument(
@@ -160,6 +159,7 @@ parser.add_argument(
     help="Delete one or more caches by number(s) (as listed with --cache-list)",
 )
 parser.add_argument(
+    "-C",
     "--clear",
     required=False,
     action="store_true",
@@ -174,6 +174,19 @@ parser.add_argument(
     action="store_true",
 )
 
+parser.add_argument(
+    "-c",
+    "--config",
+    default="",
+    help="Specify non-default config file for Neofetch/Fastfetch. Use a path or a preset name.\n"
+    "Examples:\n"
+    "- Linux/macOS:\n"
+    "  - Neofetch: 'main' → ~/.config/neofetch/main.conf\n"
+    "  - Fastfetch: 'main' → ~/.config/fastfetch/main.jsonc\n"
+    "- Windows:\n"
+    "  - Fastfetch: 'main' → %%APPDATA%%\\fastfetch\\main.jsonc",
+)
+
 
 def parse_args():
     return parser.parse_args()

{anifetch_cli-1.0.0 → anifetch_cli-1.0.2}/src/anifetch/core.py

@@ -30,15 +30,11 @@ from .utils import (
     args_checker,
     threaded_chafa_frame_gen,
     get_fetch_output,
-    center_template_to_animation,
     make_template_from_fetch_lines,
-    tput_cup,
-    get_lowest_y_pos,
-    clear_screen,
     clear_screen_soft,
 )
 from typing import Literal
-from concurrent.futures import ThreadPoolExecutor, as_completed, Future
+from concurrent.futures import ThreadPoolExecutor, Future
 
 GAP = 2
 PAD_LEFT = 4
@@ -130,6 +126,9 @@ def run_anifetch(args):
         sys.exit(0)
 
     filename = pathlib.Path(args.filename)
+    IS_GIF = False
+    if args.filename:
+        IS_GIF = True
 
     # If the filename is relative, check if it exists in the assets directory.
     if not filename.exists():
@@ -233,7 +232,7 @@ def run_anifetch(args):
 
     # Get the fetch output(neofetch/fastfetch)
     fetch_output: list[str] = get_fetch_output(
-        not args.neofetch, neofetch_status, args.force
+        not args.neofetch, neofetch_status, args.force, args.config
     )
 
     # copy fetch_output to fetch_lines
@@ -271,7 +270,9 @@ def run_anifetch(args):
                     str(
                         min(max(args.quality or 6, 2), 10)
                     ),  # 2-5 high quality, 6-10 lower
-                    str(CACHE_PATH / "video/%05d.jpg"),
+                    str(CACHE_PATH / "video/%05d.png")
+                    if IS_GIF
+                    else str(CACHE_PATH / "video/%05d.jpg"),
                 ],
                 stdout=stdout,
                 stderr=stderr,
@@ -313,8 +314,6 @@ def run_anifetch(args):
 
             cleaned_dict["sound_saved_path"] = args.sound_saved_path
 
-            cleaned_dict["sound_saved_path"] = args.sound_saved_path
-
             print_verbose(should_print_verbose, args.sound_saved_path)
 
         # If the new anim frames is shorter than the old one, then in /output there will be both new and old frames.
@@ -336,10 +335,11 @@ def run_anifetch(args):
         max_workers: int = max(1, (os.cpu_count() or 2) - 1)
         max_workers = 1
 
+        chafa_args: str = args.chafa_arguments.strip()
+        chafa_args += (
+            " --format symbols"  # Fixes https://github.com/Notenlish/anifetch/issues/1
+        )
         with ThreadPoolExecutor(max_workers=max_workers) as executor:
-            chafa_args: str = args.chafa_arguments.strip()
-            chafa_args += " --format symbols"  # Fixes https://github.com/Notenlish/anifetch/issues/1
-
             for i, f in enumerate(animation_files):
                 future = executor.submit(
                     threaded_chafa_frame_gen,
@@ -483,18 +483,21 @@ def run_anifetch(args):
 
             keyboard = Controller()
 
-            if renderer.last_key:
-                # start of line
-                keyboard.press(Key.home)
-                keyboard.release(Key.home)
+            # needed because if I only enter one key even though the user pressed a bunch of keys the keys will be entered disorderly(only the a single key is not automatically entered and the other keys are entered)
+            # so we store the key, go to line start, enter the first key(that the user pressed) and then go to the end of line.
+            # that way even if the user presses a bunch of keys, it will all be in order.
+
+            # start of line
+            keyboard.press(Key.home)
+            keyboard.release(Key.home)
 
-                keyboard.press(renderer.last_key)
+            keyboard.press(renderer.last_key)
 
-                # end of line
-                keyboard.press(Key.end)
-                keyboard.release(Key.end)
+            # end of line
+            keyboard.press(Key.end)
+            keyboard.release(Key.end)
 
-                keyboard.release(renderer.last_key)
+            keyboard.release(renderer.last_key)
 
     if pathlib.Path(VIDEO_DIR).exists():
         shutil.rmtree(VIDEO_DIR)  # no need to keep the video frames.

{anifetch_cli-1.0.0 → anifetch_cli-1.0.2}/src/anifetch/keyreader.py

@@ -2,6 +2,7 @@ import os
 import sys
 import atexit
 
+
 class KeyReader:
     """
     Cross-platform, non-blocking key reader for terminal animations.
@@ -9,12 +10,14 @@ class KeyReader:
     - macOS/Linux: termios + select
     Restores terminal settings on exit.
     """
+
     def __init__(self):
-        self.is_windows = (os.name == "nt")
+        self.is_windows = os.name == "nt"
         self._started = False
 
         if not self.is_windows:
             import termios
+
             self.termios = termios
             self.fd = sys.stdin.fileno()
             self.old_attrs = None
@@ -26,6 +29,7 @@ class KeyReader:
 
         if not self.is_windows:
             import tty
+
             self.old_attrs = self.termios.tcgetattr(self.fd)
             tty.setcbreak(self.fd)  # no-Enter input, but less aggressive than raw
             atexit.register(self.stop)
@@ -52,6 +56,7 @@ class KeyReader:
 
         if self.is_windows:
             import msvcrt
+
             if not msvcrt.kbhit():
                 return None
             ch = msvcrt.getwch()
@@ -61,6 +66,7 @@ class KeyReader:
             return ch
         else:
             import select
+
             r, _, _ = select.select([sys.stdin], [], [], 0)
             if not r:
                 return None

{anifetch_cli-1.0.0 → anifetch_cli-1.0.2}/src/anifetch/renderer.py

@@ -194,7 +194,9 @@ class Renderer:
         if self.is_centered:
             # self._some_max_height -1 is needed to properly align it for some reason. Dont question it.
             self.layout["main"]["chafa"].update(
-                Align.center(chafa_t, vertical="middle", height=self._some_max_height -1)
+                Align.center(
+                    chafa_t, vertical="middle", height=self._some_max_height - 1
+                )
             )
         else:
             self.layout["main"]["chafa"].update(chafa_t)
@@ -266,7 +268,7 @@ class Renderer:
                 refresh_per_second=20,
                 screen=True,
                 transient=True,  # if false, keep the last frame
-            ) as live:
+            ):
                 self.draw_loop()
             # enable_autowrap()
         except KeyboardInterrupt:

{anifetch_cli-1.0.0 → anifetch_cli-1.0.2}/src/anifetch/utils.py

@@ -11,8 +11,6 @@ import re
 import subprocess
 import os
 import sys
-from importlib.resources import files, as_file
-from importlib.resources.abc import Traversable
 from importlib.metadata import version, PackageNotFoundError
 import shutil
 from copy import deepcopy
@@ -44,7 +42,6 @@ SYNC_END = ESC + "?2026l"
 # Retrieved 2025-12-21, License - CC BY-SA 4.0
 
 if os.name == "nt":
-    import msvcrt
     import ctypes
 
     class _CursorInfo(ctypes.Structure):
@@ -237,6 +234,7 @@ def strip_ansi(text):
 def get_text_length_of_formatted_text(text: str):
     text = strip_ansi(text)
     return len(text)
+    # return get_character_width(text)
 
 
 def get_ext_from_codec(codec):
@@ -357,16 +355,41 @@ def get_fetch_output(
     use_fastfetch: bool,
     neofetch_status: Literal["neofetch", "uninstalled", "wrapper"],
     force_neofetch: bool,
+    config_file: str,
 ):
     fetch_output: list[str]
+
     if not use_fastfetch:  # use neofetch
         if (
             neofetch_status == "wrapper" and force_neofetch
         ) or neofetch_status == "neofetch":
             # Get Neofetch Output
-            fetch_output = subprocess.check_output(
-                ["neofetch", "--off"], text=True
-            ).splitlines()
+
+            output: list = ["neofetch", "--off"]
+            if config_file:
+                if config_file.endswith(
+                    ".conf"
+                ):  # if user input config path directly (~/.config/neofetch/custom.conf or /home/user/custom.conf etc.)
+                    if not Path(config_file).exists():
+                        print(
+                            f"Config file {config_file} not found. Make sure the path is correct.",
+                            file=sys.stderr,
+                        )
+                        sys.exit(1)
+                else:  # if user input a preset name, look for it in ~/.config/neofetch/{preset_name}.conf
+                    config_file = str(
+                        Path.home() / ".config/neofetch" / f"{config_file}.conf"
+                    )
+                    if not Path(config_file).exists():
+                        print(
+                            f"Config file {config_file} not found. Make sure the preset name is correct and the corresponding config file exists in ~/.config/neofetch/.",
+                            file=sys.stderr,
+                        )
+                        sys.exit(1)
+                output += ["--config", config_file]
+                # print(output)
+
+            fetch_output = subprocess.check_output(output, text=True).splitlines()
 
         elif neofetch_status == "uninstalled":
             print(
@@ -381,11 +404,35 @@ def get_fetch_output(
                 file=sys.stderr,
             )
             sys.exit(1)
-    else:
+    else:  # use fastfetch
         try:
-            fetch_output = subprocess.check_output(
-                ["fastfetch", "--logo", "none", "--pipe", "false"], text=True
-            ).splitlines()
+            output: list = ["fastfetch", "--logo", "none", "--pipe", "false"]
+            if config_file:
+                if config_file.endswith(
+                    ".jsonc"
+                ):  # if user input config path directly (~/.config/fastfetch/custom.jsonc or /home/user/custom.jsonc)
+                    if not Path(config_file).exists():
+                        print(
+                            f"Config file {config_file} not found. Make sure the path is correct.",
+                            file=sys.stderr,
+                        )
+                        sys.exit(1)
+
+                        # this part is actually optional because fastfetch have built in tools like this but this is for checking valid config
+                else:  # if user input a preset name, look for it in ~/.config/fastfetch/{preset_name}.jsonc
+                    config_file = str(
+                        Path.home() / ".config/fastfetch" / f"{config_file}.jsonc"
+                    )
+                    if not Path(config_file).exists():
+                        print(
+                            f"Config file {config_file} not found. Make sure the preset name is correct and the corresponding config file exists in ~/.config/fastfetch/.",
+                            file=sys.stderr,
+                        )
+                        sys.exit(1)
+                output += ["--config", config_file]
+
+            fetch_output = subprocess.check_output(output, text=True).splitlines()
+
         except FileNotFoundError as e:
             if e.errno == errno.ENOENT:
                 print(
@@ -414,6 +461,7 @@ def make_template_from_fetch_lines(
     template: list[str] = "\n".join(fetch_lines)
     # Only do this once instead of for every line.
     template_actual_width = get_text_length_of_formatted_text(fetch_lines[0])
+    # template_actual_width = max((get_text_length_of_formatted_text(line) for line in fetch_lines), default=0)
     return (template, template_actual_width)
 
 
@@ -484,6 +532,7 @@ def clean_cache_args(cache_args: dict) -> dict:
         "center",
         "loop",
         "no_key_exit",
+        "config",
     )
     cleaned = deepcopy(cache_args)  # need to deepcopy to not modify original dict.
     for key in args_to_remove:

{anifetch_cli-1.0.0 → anifetch_cli-1.0.2/src/anifetch_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anifetch-cli
-Version: 1.0.0
+Version: 1.0.2
 Summary: Animated terminal fetch with video and audio support.
 Author-email: Notenlish <notenlish@gmail.com>
 Maintainer: Immelancholy
@@ -65,7 +65,12 @@ winget install chafa ffmpeg fastfetch
 
 You can install neofetch too but it is deprecated and not recommended. Run this to install: `winget install neofetch`
 
-You can then install anifetch via `pip install anifetch-cli`. You can install it via pipx too by doing: `pipx install anifetch-cli`
+After installing the necessary dependencies using winget/scoop, install anifetch via pip. You can install it via pipx too.
+
+```pip install anifetch-cli```
+
+> [!WARNING]
+> **Do not** install `anifetch` on pypi, it is not related with this project. Install `anifetch-cli`.
 
 ### Installation for MacOS with Homebrew
 
@@ -77,8 +82,12 @@ Run this in the terminal after verifying homebrew is installed:
 brew install chafa ffmpeg fastfetch
 ```
 
-You can then install anifetch via `pip install anifetch-cli`. You can install it via pipx too via `pipx install anifetch-cli`
+After installing the necessary dependencies, install anifetch via pip . You can install it via pipx too.
 
+```pip install anifetch-cli```
+
+> [!WARNING]
+> **Do not** install `anifetch` on pypi, it is not related with this project. Install `anifetch-cli`.
 
 ### Manual Installation
 
@@ -256,6 +265,12 @@ _Note : by default, the video `example.mp4` can directly be used as an example._
 - `--quality`: Changes the output quality of ffmpeg when extracting frames. This doesn't have much effect on the quality or speed from my testing, so you shouldn't need to change this. 2 highest quality, 10 lowest quality.
 - `--loop`: Determines how many times the animation should loop. Default is -1(always loop).
 - `--no-key-exit`: Don't exit anifetch when user presses a key.
+- `-c` / `--config`: Specify a non-default config for Neofetch/Fastfetch.
+  - Accepts a path or preset name (e.g. `main`).
+  - Neofetch (Linux/macOS): `~/.config/neofetch/main.conf`
+  - Fastfetch (Linux/macOS): `~/.config/fastfetch/main.jsonc`
+  - Fastfetch (Windows): `%APPDATA%\fastfetch\main.jsonc`
+  - See [Customizing Fastfetch/Neofetch](#customizing-fastfetchneofetch-output) for config details.
 
 ### Cached files:
 
@@ -309,6 +324,8 @@ As it can be seen, Anifetch is quite fast if you cache the animations.
 
 Make sure to install the dependencies listed on [Prerequisites](#Prerequisites). If ffmpeg throws an error saying `libxm12.so.16: cannot open shared object file: No such file or directory exists` then you must install `libxm12`. Here's an comment showing how to install it for arch: [https://github.com/Notenlish/anifetch/issues/24#issuecomment-2920189918](solution)
 
+If weird characters are appearing in your terminal then your terminals font probably can't render some characters. Consider installling [nerdfonts](https://www.nerdfonts.com/).
+
 ## Notes
 
 Anifetch attempts to cache the animation so that it doesn't need to render them again when you run it with the same file. However, if the name of the file is the same, but it's contents has changed, it won't re-render it. In that case, you will need to add `--force-render` as an argument to `anifetch.py` so that it re-renders it. You only have to do this only once when you change the file contents.