From 32f0d1de88c4caeb10d971a133af34880ba4d149 Mon Sep 17 00:00:00 2001 From: Trysdyn Black Date: Sun, 30 Oct 2022 08:30:03 -0700 Subject: [PATCH] First commit from local working tree --- LICENSE.md | 21 ++ README.md | 90 +++++++- config.py | 306 ++++++++++++++++++++++++++ default/default_blink_closed.png | Bin 0 -> 9663 bytes default/default_blink_open.png | Bin 0 -> 12234 bytes default/default_closed.png | Bin 0 -> 8190 bytes default/default_open.png | Bin 0 -> 14030 bytes default/profile.yaml | 17 ++ main.pyw | 354 +++++++++++++++++++++++++++++++ ptv.yaml | 36 ++++ pyproject.toml | 4 + requirements.txt | 6 + 12 files changed, 832 insertions(+), 2 deletions(-) create mode 100644 LICENSE.md create mode 100644 config.py create mode 100644 default/default_blink_closed.png create mode 100644 default/default_blink_open.png create mode 100644 default/default_closed.png create mode 100644 default/default_open.png create mode 100644 default/profile.yaml create mode 100644 main.pyw create mode 100644 ptv.yaml create mode 100644 pyproject.toml create mode 100644 requirements.txt diff --git a/LICENSE.md b/LICENSE.md new file mode 100644 index 0000000..c0104ed --- /dev/null +++ b/LICENSE.md @@ -0,0 +1,21 @@ +ANTI-CAPITALIST SOFTWARE LICENSE (v 1.4) + +Copyright © 2022 Trysdyn Black + +This is anti-capitalist software, released for free use by individuals and organizations that do not operate by capitalist principles. + +Permission is hereby granted, free of charge, to any person or organization (the "User") obtaining a copy of this software and associated documentation files (the "Software"), to use, copy, modify, merge, distribute, and/or sell copies of the Software, subject to the following conditions: + +1. The above copyright notice and this permission notice shall be included in all copies or modified versions of the Software. + +2. The User is one of the following: +a. An individual person, laboring for themselves +b. A non-profit organization +c. An educational institution +d. An organization that seeks shared profit for all of its members, and allows non-members to set the cost of their labor + +3. If the User is an organization with owners, then all owners are workers and all workers are owners with equal equity and/or equal vote. + +4. If the User is an organization, then the User is not law enforcement or military, or working for or under either. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT EXPRESS OR IMPLIED WARRANTY OF ANY KIND, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. diff --git a/README.md b/README.md index cd5fba3..a9320c9 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,89 @@ -# pyngtube +# Pyngtube +A simplistic Python application for two-state animation PNGtubing, using only flatfiles and images for configuration. -Simplistic flat-file based no-frills pngtuber application written in Python \ No newline at end of file + +## Why Another VTuber App? +Several applications exist in this space, but most of them are either non-free or complicated and use strange marshalled data formats while providing excessive, confusing features that are not necessary for a simple approach. Pyngtube aims to provide a simple set of features in an accessible format using only flat images and YAML files in a way that can be understood and put into use in minutes. + +Pyngtube targets a simple "two-state animation" approach. It doesn't do any kind of facial detection and instead monitors microphone amplitude. The application displays a "closed mouth" image when the microphone is quiet and an "open mouth" image when it's not. That's all there is to it. + +A couple of other fun features exist such as minor movement animations when the user is talking and randomized blinking, but these are wholly optional and default to off if not configured at all. They can be ignored if all you want is the core experience. + + +## Requirements and Installation +pyngtube is built for Python3. Python2 is long since EOLed; no support will be provided. Python 3.6 should be the minimum required version but is testing on 3.9 and 3.10. + +pyngtube requires tkinter, Pygame, PyYAML, and PyAudio. Fairly hefty requirements for what it does. You can get a simplified rundown in `requirements.txt`. + +Installation should be fairly simple. The most direct approach is to install the pre-requisites using Pip like so. + +``` +pip install -r requirements.txt +``` + +However good housekeeping requires creating a Python Virtualenv for the pre-reqs. Virtualenvs are a good thing to know if you use Python code in any capacity, but a short rundown of how to do this: + +### Linux + +``` +python -m venv pyngtube-env +source pyngtube-env/bin/activate +pip install -r requirements.txt +``` + +### Windows + +``` +python -m venv pyngtube-env +pyngtube-env\Scripts\activate +pip install -r requirements.txt +``` + +If you utilized a virtualenv, you will need to activate it before launching pyngtube to make sure you're using the environment properly. + +If you run into build errors at the `pip install` step you're likely on an OS that requires building python libs from scratch. Hopefully this means you're on Linux and have some inkling of how to proceed from here. It might just require installing your distro's build tools. + + +## Usage +Basic launching can be accomplished with `python main.pyw` in the pyngtube dir, or double-clicing the main.pyw file. This should launch a default experience with a very crappy hand-drawn default avatar. + +There is no user interface. You can scroll the mousewheel inside the window to change the microphone threshold and can right-click in the window to open a dialog to select a new profile to load. See Configuration below for avatar configuration specs. + + +## Configuration +The main configuration file is ptv.yaml, in the same directory as main.pyw. You may also manually provide a different config file location as an argument to main.pyw. + +This file is a standard yaml file of configuration directives. It is recommended that this main config file only include the bare necessities of configuring the program: microphone settings and window size if you need it. Then the avatar settings should be imported via a profile declared with the `profile` directive. + +A profile is a directory that consists of a second configuration yaml file, and all the images needed to make the avatar work. The `profile` directive should be simply the name of the directory and the yaml file must be named profile.yaml. Pyngtube will attempt to find this profile in the pyngtube installation directory. profile.yaml must declare the images to be used for the avatar. + + +## Troubleshooting +If the app crashes, closes suddenly, or doesn't open at all, the first step is to launch the app from a command line and see if any errors are printed. The only real cause for a launch failure should be a broken config file, which will print an error explaining the problem. + +Configuration errors are fatal (causing a forced exit) by design, including invalid keys in the configuration file. + +If the terminal outputs errors about your system not being built to support tcl/tk, tkinter, etc, you're likely missing a tcl/tk package. This should only happen under Linux; Windows installs of Python should always support tk. + + +## Known Issues +First and foremost, this is a personal tool I'm making available as an (arguably bad) example and starting point for someone else's personal tool. This means assumptions are made about my environment that may not work in your environment. Certain bugs I may not care about that you do. Here's a list of what I can think of that's a little "off" right now: + +* The application is not hardware accelerated, so CPU usage can get a little high (for my taste anyway, 3-5% on my dev box) if you're scaling a small image to a massive one or vise-versa. This is an easy fix with better buffer handling and is on The List +* Due to design praxis of not drawing anything over the capture region to "ruin the magic" of the avatar, there is no visible feedback on threshold changes. You have to trust mousewheeling in the window changes threshold +* For that matter, there's no way to change threshold if you're using a pointing device without a wheel short of editing the config file +- What little debugging and error raising there is prints to the console. This needs to be reworked to raise actual GUI errors +- pyngtube makes the awkward assumption that you have one audio input device. It should work fine even if you don't, but some configuration around this should be provided +- I don't like the dependency on tkinter because it's undisclosed and cannot be put into `requirements.txt` but the greater evil prior was a depdency on wxPython which has a massive build and install process. Most py installations come with tkinter bundled + + +## Contributing +My Gitea instance is closed to new registrations so contributions aren't really accepted at the moment. If you must submit a code change, let me know and I'll arrange something. + +Code is formatted with [python-black](https://github.com/psf/black) before commit. + + +## Why The Weird License? +The [ACSL](https://anticapitalist.software/) most closely aligns with how I want things I create to be used. In a better world I'd license things MIT or even some variant of CC-BY, but I've seen and experienced time and time again that fully open software tends to filter up, benefitting the largest corporations more than the common user. This results in megacorps benefitting while providing nothing in return and, in the worst cases, even demanding FOSS devs perform free labor for them to perform their security audits, investigate their change requests for their specific use cases, and the like. + +I hold no illusion that anything I make will ever be important, but I refuse to even put myself in the position where that could occur. Is the ACSL enforceable? That's a matter of test-by-trial. It says what I want to say with my work; that's what matters. diff --git a/config.py b/config.py new file mode 100644 index 0000000..585e048 --- /dev/null +++ b/config.py @@ -0,0 +1,306 @@ +import os +import sys +import yaml + + +class Config: + def __init__(self): + # Load initial config file + if len(sys.argv) > 1: + config_file = sys.argv[1] + else: + config_file = os.path.join(os.path.dirname(__file__), "ptv.yaml") + self.load_config(config_file) + + # Load the profile explicitly at the end of initiailization so that + # profile settings take precedence over global config settings + self.load_config(os.path.join(self.profile, "profile.yaml")) + + def load_config(self, filename): + with open(filename, "r") as infile: + self._image_closed = None + self._image_open = None + self._image_blink_closed = None + self._image_blink_open = None + + for k, v in yaml.load(infile, Loader=yaml.Loader).items(): + # This ugly thing checks if a config parameter named in the + # config file maps to a class property. If not, we throw an + # error and exit because the config file is broken. + # FIXME: Find a better way to do this + if not isinstance(getattr(type(self), k, None), property): + print(f"Invalid config paramter: {k}") + sys.exit(1) + setattr(self, k, v) + + @property + def profile(self): + try: + return self._profile + except AttributeError: + print("profile is a required parameter") + sys.exit(1) + + @profile.setter + def profile(self, profile): + # Check filename is a string + if not isinstance(profile, str): + print("Config paramter profile must be a valid filename") + sys.exit(1) + + # Look for file in working dir and script dir + targets = [os.path.join(os.path.dirname(__file__), profile), profile] + + for target in targets: + if os.path.exists(target): + if not os.path.exists(os.path.join(target, "profile.yaml")): + print(f"Profile path {profile} does not contain a profile.yaml file") + sys.exit(1) + self._profile = target + self.load_config(os.path.join(target, "profile.yaml")) + return + + # Can't find the profile file, fail + print(f"Cannot find file {profile}") + sys.exit(1) + + @property + def image_closed(self): + try: + return self._image_closed + except AttributeError: + print("image_closed is a required paramter") + sys.exit(1) + + @image_closed.setter + def image_closed(self, filename): + # Check filename is a string + if not isinstance(filename, str): + print("Config parameter image_closed must be a valid filename") + + # Look for the file in profile dir, script dir, and working dir + targets = [os.path.join(self.profile, filename), os.path.join(os.path.dirname(__file__), filename), filename] + + for target in targets: + if os.path.exists(target): + self._image_closed = target + return + + # Can't find the image, fail + print(f"Cannot find file {filename}") + sys.exit(1) + + @property + def image_open(self): + try: + return self._image_open + except AttributeError: + return None + + @image_open.setter + def image_open(self, filename): + # Check filename is a string + if not isinstance(filename, str): + print("Config parameter image_open must be a valid filename") + + # Look for the file in profile dir, script dir, and working dir + targets = [os.path.join(self.profile, filename), os.path.join(os.path.dirname(__file__), filename), filename] + + for target in targets: + if os.path.exists(target): + self._image_open = target + return + + # Can't find the image, fail + print(f"Cannot find file {filename}") + sys.exit(1) + + @property + def image_blink_open(self): + try: + return self._image_blink_open + except AttributeError: + return None + + @image_blink_open.setter + def image_blink_open(self, filename): + # Check filename is a string + if not isinstance(filename, str): + print("Config parameter image_blink_open must be a valid filename") + + # Look for the file in profile dir, script dir, and working dir + targets = [os.path.join(self.profile, filename), os.path.join(os.path.dirname(__file__), filename), filename] + + for target in targets: + if os.path.exists(target): + self._image_blink_open = target + return + + # Can't find the image, fail + print(f"Cannot find file {filename}") + sys.exit(1) + + @property + def image_blink_closed(self): + try: + return self._image_blink_closed + except AttributeError: + return None + + @image_blink_closed.setter + def image_blink_closed(self, filename): + # Check filename is a string + if not isinstance(filename, str): + print("Config parameter image_blink_closed must be a valid filename") + + # Look for the file in profile dir, script dir, and working dir + targets = [os.path.join(self.profile, filename), os.path.join(os.path.dirname(__file__), filename), filename] + + for target in targets: + if os.path.exists(target): + self._image_blink_closed = target + return + + # Can't find the image, fail + print(f"Cannot find file {filename}") + sys.exit(1) + + @property + def bg_color(self): + try: + return self._bg_color + except AttributeError: + return (0, 0, 0) + + @bg_color.setter + def bg_color(self, color): + if not isinstance(color, (list, tuple)) or len(color) != 3: + print("Config parameter bg_color must be a three-item list") + sys.exit(1) + self._bg_color = color + + @property + def audio_checks(self): + try: + return self._audio_checks + except AttributeError: + return 60 + + @audio_checks.setter + def audio_checks(self, checks): + if not isinstance(checks, int): + print("Config parameter audio_checks must be an integer") + sys.exit(1) + self._audio_checks = checks + + @property + def threshold(self): + try: + return self._threshold + except AttributeError: + return 6000 + + @threshold.setter + def threshold(self, threshold): + if not isinstance(threshold, int): + print("Config parameter threshold must be an integer") + sys.exit(1) + self._threshold = threshold + + @property + def smoothing(self): + try: + return self._smoothing + except AttributeError: + return 3 + + @smoothing.setter + def smoothing(self, smoothing): + if not isinstance(smoothing, int): + print("Config paramter smoothing must be an integer") + sys.exit(1) + self._smoothing = smoothing + + @property + def mic_rate(self): + try: + return self._mic_rate + except AttributeError: + return 44100 + + @mic_rate.setter + def mic_rate(self, rate): + if not isinstance(rate, int): + print("Config paramter mic_rate must be an integer") + sys.exit(1) + self._mic_rate = rate + + @property + def mic_stereo(self): + try: + return self._mic_stereo + except AttributeError: + return True + + @mic_stereo.setter + def mic_stereo(self, is_stereo): + if not isinstance(is_stereo, bool): + print("Config paramter mic_stereo must be a boolean") + sys.exit(1) + self._mic_stereo = True + + @property + def blink_frames(self): + try: + return self._blink_frames + except AttributeError: + return 0 + + @blink_frames.setter + def blink_frames(self, frames): + if not isinstance(frames, int): + print("Config parameter blink_frames must be an integer") + sys.exit(1) + self._blink_frames = frames + + @property + def blink_chance(self): + try: + return self._blink_chance + except AttributeError: + return 0 + + @blink_chance.setter + def blink_chance(self, chance): + if not isinstance(chance, float) and not isinstance(chance, int): + print("Config parameter blink_chance must be an integer or float") + sys.exit(1) + self._blink_chance = chance + + @property + def shake_delay(self): + try: + return self._shake_delay + except AttributeError: + return 0 + + @shake_delay.setter + def shake_delay(self, delay): + if not isinstance(delay, int): + print("Config parameter shake_delay must be an integer") + sys.exit(1) + self._shake_delay = delay + + @property + def shake_intensity(self): + try: + return self._shake_intensity + except AttributeError: + return 0 + + @shake_intensity.setter + def shake_intensity(self, intensity): + if not isinstance(intensity, int): + print("Config parameter shake_intensity must be an integer") + sys.exit(1) + self._shake_intensity = intensity diff --git a/default/default_blink_closed.png b/default/default_blink_closed.png new file mode 100644 index 0000000000000000000000000000000000000000..a6184aa5a29da07fb43c74539bfac60d332a93fa GIT binary patch literal 9663 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 literal 0 HcmV?d00001 diff --git a/default/default_closed.png b/default/default_closed.png new file mode 100644 index 0000000000000000000000000000000000000000..a12bb311df7895ba2440df2fd131964426e996ad GIT binary patch literal 8190 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 bool + Evaluate buffered audio data and return true if the average amplitude is over the configured threshold. + Indicates the mic is hot. Also drains the audio buffer. + """ + + def __init__(self, channels: int, rate: int, frames: int, threshold: int = 5000, smoothing: int = 0) -> None: + """ + Parameters + ---------- + channels : int + Number of audio channels in the input device, usually 1 or 2 for mono/stereo + rate : int + Baud rate of the audio device, typically 44100 or 48000 as configured in Windows + frames : int + Number of times a second to check the audio buffer. The buffer is fully drained each check + threshold : int + Audio amplitude at which we consider the mic hot + smoothing : int + Number of frames we continue to consider the mic hot after it stops being hot + """ + p = pyaudio.PyAudio() + self.frames = frames + self.stream = p.open( + format=pyaudio.paInt16, + channels=channels, + rate=rate, + input=True, + frames_per_buffer=frames, + ) + + self.threshold = threshold + self.smoothing = smoothing + self.this_smooth = 0 + + def get_state(self) -> bool: + """Check audio buffer and indicate if the avatar's mouth should be open this frame. + + Returns + ------- + bool + Returns true if the avatar's mouth should be considered open this frame + """ + # Grab a window of mic data into integer representations + data = self.stream.read(self.frames, exception_on_overflow=False) + a_data = array.array("h", data) + + # Return true if we're over threshold or it's been fewer than smooth + # checks since the last time we were over threshold. + if max(a_data) > self.threshold: + self.this_smooth = self.smoothing + return True + elif self.this_smooth: + self.this_smooth -= 1 + return True + + return False + + +class Tube: + """Encapsulates avatar and windowing logic, handles drawing. + + Methods + ------- + should_blink() -> bool + Evaluate all available settings and data and return true if the avatar should be blinking this frame. + update() + Perform one frame of checks, logic, and prep and draw the avatar. + """ + + def __init__( + self, + image_closed: str, + image_open: typing.Optional[str] = None, + image_blink_closed: typing.Optional[str] = None, + image_blink_open: typing.Optional[str] = None, + blink_chance: int = 0, + blink_frames: int = 0, + shake_intensity: int = 0, + shake_delay: int = 0, + win_size: typing.Optional[tuple] = None, + bg_color: tuple = (0, 255, 0), + ) -> None: + """ + Parameters + ---------- + image_closed : string + Filename for the image to load for a opened eyes/closed mouth avatar state. + Mandatory. + image_open : string or None + Filename for the image to load for a opened eyes/opened mouth avatar state. + Defaults to None. + image_blink_closed : string or None + Filename for the image to load for a closed eyes/closed mouth avatar state. + Defaults to None. + image_blink_open : string + Filename for the image to load for a closed eyes/opened mouth avatar state. + Defaults to None. + blink_chance : float + A chance, out of 1.0, to activate blinking each frame of rendering. + Defaults to 0 to disable blinking. + blink_frames : int + How many frames to hold the eyes-closed state after activating a blink. + Defaults to 0 to disable blinking. + shake_intensity : int + How far in pixels to limit movement on each axis when shaking. + Defaults to 0 to disable shaking. + shake_delay : int + How many frames to prevent shaking after completing a prior shake. + Defaults to 0. + win_size : tuple(int, int) or None + Window size as a tuple of ints (width, height). + Defaults to None, which uses the image size of image_closed instead. + bg_color : tuple(int, int, int) + Background color as a tuple of ints (red, green, blue). + Defaults to (0, 255, 0) for greenscreen green. + """ + self.open_frames = 0 + self.blinked_frames = 0 + + # These display settings are temporary. We can't load images without it + self.display = pygame.display.set_mode((400, 300)) + pygame.display.set_caption("pyngtube") + + # Closed mouth image is mandatory + self.image_closed = pygame.image.load(image_closed).convert_alpha() + + # Open mouth image is optional + if image_open: + self.image_open = pygame.image.load(image_open).convert_alpha() + else: + self.image_open = None + + # Blinking images are optional + if image_blink_closed: + self.image_blink_closed = pygame.image.load(image_blink_closed).convert_alpha() + else: + self.image_blink_closed = None + + if image_blink_open: + self.image_blink_open = pygame.image.load(image_blink_open).convert_alpha() + else: + self.image_blink_open = None + + # Establish our blink settings + self.blink_chance = blink_chance + self.blink_frames = blink_frames + + # If we only have a closed-mouth image (why?) use it for open-mouth too + using_image_open = self.image_open if self.image_open else self.image_closed + + # State map for which image to use. (Mouth Opened?, Blinked?) + # If we don't have blinked images, we use the non-blinked images for those slots + self.state_map = { + (False, False): self.image_closed, + (True, False): using_image_open, + (False, True): self.image_blink_closed if self.image_blink_closed else self.image_closed, + (True, True): self.image_blink_open if self.image_blink_open else using_image_open, + } + + # If we specified a window size, use it. If not use closed image size + # Then we pad by 10px to allow for shaking + if not win_size: + win_size = self.image_closed.get_size() + + self.win_size = ( + win_size[0] + (shake_intensity * 2), + win_size[1] + (shake_intensity * 2), + ) + + # Background color to blank with, likely a greenscreen color + self.bg_color = bg_color + + # Shaking intensity. Numer of frames to wait before shaking + self.shake_intensity = shake_intensity + self.shake_delay = shake_delay + + # Create our drawing buffer and initialize true display size + self.buf = pygame.surface.Surface(self.image_closed.get_size()) + self.display = pygame.display.set_mode(self.win_size, pygame.RESIZABLE) + + def should_blink(self) -> bool: + """Check if we're currently blinking and check blink_chance to indicate if we should be blinking this frame. + + Returns + ------- + bool + Returns true if the avatar's eyes should be considered closed this frame. + """ + # If we're blinking and haven't reached the configured blink duration yet + # extend blinking by a frame to keep the eyes shut. + # Otherwise roll blink chance and set blink if the roll wins. + if self.blinked_frames and self.blinked_frames < self.blink_frames: + self.blinked_frames += 1 + return True + else: + if random.random() < self.blink_chance: + self.blinked_frames += 1 + return True + + self.blinked_frames = 0 + return False + + def update(self, opened: bool, blinked: bool) -> None: + """Perform updates and drawing for one frame. This should be called once a frame and fed avatar state info on + open mouth and blinking. This handles all the other placement, style, and drawing functions from there. + + Parameters + ---------- + opened : bool + true if the avatar's mouth should be open this frame. + blinked : bool + true if the avatar's eyes should be closed this frame. + """ + # Blank with bg_color + self.display.fill(self.bg_color) + self.buf.fill(self.bg_color) + + # Jitter tracks our offset from origin for shaking + # It's applied as a transformation to image location each frame + jitter = (0, 0) + i = self.shake_intensity + + # Figure out which image we're drawing this frame using our state map + this_frame_image = self.state_map[(opened, blinked)] + + # If the mic state is opened and an open mouth image exists, blit it + # to the drawing buffer. Otherwise use the closed mouth image. + if opened and self.image_open: + self.open_frames += 1 + + # Randomize our jitter if we're currently shaking + if self.shake_delay and not self.open_frames % self.shake_delay: + jitter = (random.randint(-i, i), random.randint(-i, i)) + else: + self.open_frames = 0 + jitter = (0, 0) + + # Draw our chosen image to a drawing buffer + self.buf.blit(this_frame_image, (0, 0)) + + # Resize the drawing buffer to the window size if necessary + # Scale on the vertical axis to maximum window size. + # If we're configured to shake the sprite on open mic, randomly + # jitter the sprite around the frame a bit while mic is open. + display_size = self.display.get_size() + shrunk_size = (display_size[0] - (i * 2), display_size[1] - (i * 2)) + if self.buf.get_size() != shrunk_size: + new_buf = pygame.transform.scale(self.buf, shrunk_size) + self.display.blit(new_buf, (i + jitter[0], i + jitter[1])) + else: + self.display.blit(self.buf, (i + jitter[0], i + jitter[1])) + + pygame.display.flip() + + +if __name__ == "__main__": + # Hide Pygame "Hello world" stuff. Why does this require an envvar :/ + + # I use some not-great extreme shorthand in the main loop here: + # c = config object + # a = audio subsystem object + # t = pngtube object, the window and avatar object + quit = False + rehash = True + root = tkinter.Tk() + root.withdraw() + pygame.init() + + # Load config + c = config.Config() + + # Initialize audio system + a = Audio( + channels=2 if c.mic_stereo else 1, + rate=c.mic_rate, + frames=int(c.mic_rate / c.audio_checks), + threshold=c.threshold, + smoothing=c.smoothing, + ) + + while not quit: + # Reload our avatar if we've been instructed to rehash settings + if rehash: + t = Tube( + image_closed=c.image_closed, + image_open=c.image_open, + image_blink_closed=c.image_blink_closed, + image_blink_open=c.image_blink_open, + blink_chance=c.blink_chance, + blink_frames=c.blink_frames, + bg_color=c.bg_color, + shake_delay=c.shake_delay, + shake_intensity=c.shake_intensity, + ) + rehash = False + for event in pygame.event.get(): + # Clean shutdown if user clicks the [X] + if event.type == QUIT: + pygame.quit() + a.stream.close() + quit = True + break + # If the window gets resized, handle redrawing the window in the new size + elif event.type == pygame.VIDEORESIZE: + # Scale only on vertical axis. Force horizontal axis to match + # the drawing buffer's aspect ratio. + win_size = (event.w, event.h) + buf_ratio = t.buf.get_width() / t.buf.get_height() + t.win_size = (win_size[1] * buf_ratio, win_size[1]) + t.display = pygame.display.set_mode(t.win_size, pygame.RESIZABLE) + # Mouse wheel up and down changes mic threshold. + # TODO: Provide some kind of user feedback + # But I don't want it visible in the capture region + elif event.type == pygame.MOUSEWHEEL: + a.threshold += event.y * 100 + print(a.threshold) + # RMB to open load file dialog for profile + elif event.type == pygame.MOUSEBUTTONDOWN: + if event.button == 3: + file_types = [("yaml files", "profile.yaml")] + file_path = filedialog.askopenfilename(title="Select a profile", filetypes=file_types) + if file_path: + c.profile = os.path.dirname(file_path) + rehash = True + + # Check mic, update image + if not quit: + t.update(a.get_state(), t.should_blink()) diff --git a/ptv.yaml b/ptv.yaml new file mode 100644 index 0000000..66fd551 --- /dev/null +++ b/ptv.yaml @@ -0,0 +1,36 @@ +--- +# Which profile to use by default +# This must be a directory that contains a profile.yaml and all +# the avatar images +profile: 'default' + +# How many times per second audio is checked +# This also impacts FPS of the avatar +audio_checks: 60 + +# Mic amplitude level we consider "Talking" +threshold: 5000 + +# Once the avatar's mouth is open it remains open for at minimum +# this many frames +smoothing: 3 + +# Microphone audio rate. This should match the inpute rate configured +# in Windows. In 99.9% of cases 44100 is the right answer. +mic_rate: 44100 + +# If the mic is stereo or not. true or false +mic_stereo: true + +# How many frames we wait between shakes if avatar shaking is configured +shake_delay: 6 + +# How many pixels in a random direction we shake the avatar each shake +# Setting this to 0 disables shaking +shake_intensity: 0 + +# Chance per frame to have the avatar blink. 0 disables this +blink_chance: 0.003 + +# How many frames, once we blink, we display the eyes closed images +blink_frames: 10 diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..d29030f --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,4 @@ +[tool.black] +line-length = 120 +target-version = ['py310'] +include = '\.pyw?$' diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..b3c95cd --- /dev/null +++ b/requirements.txt @@ -0,0 +1,6 @@ +numpy==1.23.4 +Pillow==9.3.0 +PyAudio==0.2.12 +pygame==2.1.2 +PyYAML==6.0 +six==1.16.0