beets-quicktag 0.1.0__tar.gz

beets_quicktag-0.1.0/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: beets-quicktag
+Version: 0.1.0
+Summary: A beets plugin for quickly tagging tracks with customizable attributes
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: beets>=2.3.0
+Requires-Dist: just-playback>=0.1.8
+Requires-Dist: textual>=3.2.0
+
+# Beets QuickTag Plugin
+
+This is a plugin for [beets](https://beets.io/) that scratches my own itch to categorize my music using custom tags, for DJing, as efficiently as possible. If it's not at a 1.0 release, it's probably not stable for use by others, though I'll still try and look at issues if for some reason you've found this (hi!).
+
+It's a work in progress though much of the functionality is already there. I initially prototyped this using Claude 3.7 and Gemini 2.5 Pro Preview but ended up re-working quite a bit of it.
+
+TODO:
+- add tests
+- add rating or energy level widget
+- consider bundling libmpv
+- automate releases
+- test on Windows
+- summarize changes after QuickTag finishes running
+- consider bundling libmpv
+
+## Requirements
+
+You must have `libmpv` installed.
+
+## Configuration
+
+Add a `quicktag` section to your beets `config.yaml`. Here's an example:
+
+```yaml
+
+quicktag:
+  autoplay_at_launch: yes
+  autoplay_on_track_change: no
+  autosave_on_quit: yes
+  categories:
+    collection:
+      - DJ
+      - Sample
+    mood:
+      - happy
+      - sad
+      - bright
+      - dark
+      - angry
+```
+
+## Credits
+
+This was inspired by the Quick Tag functionality in [One Tagger](https://onetagger.github.io/), which is an excellent application. One Tagger also has [a spreadsheet](https://docs.google.com/spreadsheets/d/1wYokScjoS5Xb1IvqFMXbSbknrXJ7bySLLihTucOS4qY/edit?gid=0#gid=0) that might provide inspiration from existing systems to categorize tracks in this way. I believe the One Tagger system, or at least the default categories it has, are inspired by [a reddit post by u/nonomomomo](https://www.reddit.com/r/DJs/comments/c3o2jk/my_ultimate_track_tagging_system_the_little_data/).

beets_quicktag-0.1.0/README.md

@@ -0,0 +1,44 @@
+# Beets QuickTag Plugin
+
+This is a plugin for [beets](https://beets.io/) that scratches my own itch to categorize my music using custom tags, for DJing, as efficiently as possible. If it's not at a 1.0 release, it's probably not stable for use by others, though I'll still try and look at issues if for some reason you've found this (hi!).
+
+It's a work in progress though much of the functionality is already there. I initially prototyped this using Claude 3.7 and Gemini 2.5 Pro Preview but ended up re-working quite a bit of it.
+
+TODO:
+- add tests
+- add rating or energy level widget
+- consider bundling libmpv
+- automate releases
+- test on Windows
+- summarize changes after QuickTag finishes running
+- consider bundling libmpv
+
+## Requirements
+
+You must have `libmpv` installed.
+
+## Configuration
+
+Add a `quicktag` section to your beets `config.yaml`. Here's an example:
+
+```yaml
+
+quicktag:
+  autoplay_at_launch: yes
+  autoplay_on_track_change: no
+  autosave_on_quit: yes
+  categories:
+    collection:
+      - DJ
+      - Sample
+    mood:
+      - happy
+      - sad
+      - bright
+      - dark
+      - angry
+```
+
+## Credits
+
+This was inspired by the Quick Tag functionality in [One Tagger](https://onetagger.github.io/), which is an excellent application. One Tagger also has [a spreadsheet](https://docs.google.com/spreadsheets/d/1wYokScjoS5Xb1IvqFMXbSbknrXJ7bySLLihTucOS4qY/edit?gid=0#gid=0) that might provide inspiration from existing systems to categorize tracks in this way. I believe the One Tagger system, or at least the default categories it has, are inspired by [a reddit post by u/nonomomomo](https://www.reddit.com/r/DJs/comments/c3o2jk/my_ultimate_track_tagging_system_the_little_data/).

beets_quicktag-0.1.0/beets_quicktag.egg-info/PKG-INFO

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: beets-quicktag
+Version: 0.1.0
+Summary: A beets plugin for quickly tagging tracks with customizable attributes
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: beets>=2.3.0
+Requires-Dist: just-playback>=0.1.8
+Requires-Dist: textual>=3.2.0
+
+# Beets QuickTag Plugin
+
+This is a plugin for [beets](https://beets.io/) that scratches my own itch to categorize my music using custom tags, for DJing, as efficiently as possible. If it's not at a 1.0 release, it's probably not stable for use by others, though I'll still try and look at issues if for some reason you've found this (hi!).
+
+It's a work in progress though much of the functionality is already there. I initially prototyped this using Claude 3.7 and Gemini 2.5 Pro Preview but ended up re-working quite a bit of it.
+
+TODO:
+- add tests
+- add rating or energy level widget
+- consider bundling libmpv
+- automate releases
+- test on Windows
+- summarize changes after QuickTag finishes running
+- consider bundling libmpv
+
+## Requirements
+
+You must have `libmpv` installed.
+
+## Configuration
+
+Add a `quicktag` section to your beets `config.yaml`. Here's an example:
+
+```yaml
+
+quicktag:
+  autoplay_at_launch: yes
+  autoplay_on_track_change: no
+  autosave_on_quit: yes
+  categories:
+    collection:
+      - DJ
+      - Sample
+    mood:
+      - happy
+      - sad
+      - bright
+      - dark
+      - angry
+```
+
+## Credits
+
+This was inspired by the Quick Tag functionality in [One Tagger](https://onetagger.github.io/), which is an excellent application. One Tagger also has [a spreadsheet](https://docs.google.com/spreadsheets/d/1wYokScjoS5Xb1IvqFMXbSbknrXJ7bySLLihTucOS4qY/edit?gid=0#gid=0) that might provide inspiration from existing systems to categorize tracks in this way. I believe the One Tagger system, or at least the default categories it has, are inspired by [a reddit post by u/nonomomomo](https://www.reddit.com/r/DJs/comments/c3o2jk/my_ultimate_track_tagging_system_the_little_data/).

beets_quicktag-0.1.0/beets_quicktag.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+README.md
+pyproject.toml
+beets_quicktag.egg-info/PKG-INFO
+beets_quicktag.egg-info/SOURCES.txt
+beets_quicktag.egg-info/dependency_links.txt
+beets_quicktag.egg-info/requires.txt
+beets_quicktag.egg-info/top_level.txt
+beetsplug/quicktag/__init__.py
+beetsplug/quicktag/app.py
+beetsplug/quicktag/widgets/custom_selection_list.py
+beetsplug/quicktag/widgets/input_with_label.py
+beetsplug/quicktag/widgets/playback.py
+beetsplug/quicktag/widgets/playback_progress.py
+tests/test_app.py
+tests/test_config.py
+tests/test_integration.py
+tests/test_playback.py
+tests/test_widgets.py

beets_quicktag-0.1.0/beets_quicktag.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

beets_quicktag-0.1.0/beets_quicktag.egg-info/requires.txt

@@ -0,0 +1,3 @@
+beets>=2.3.0
+just-playback>=0.1.8
+textual>=3.2.0

beets_quicktag-0.1.0/beets_quicktag.egg-info/top_level.txt

@@ -0,0 +1 @@
+beetsplug

beets_quicktag-0.1.0/beetsplug/quicktag/__init__.py

@@ -0,0 +1,76 @@
+import optparse
+
+from beets import ui
+from beets.dbcore.db import Results as BeetsResults
+from beets.library import Library as BeetsLibrary
+from beets.plugins import BeetsPlugin
+
+from .app import QuickTagApp
+
+
+class QuickTagPlugin(BeetsPlugin):
+    def __init__(self):
+        super(QuickTagPlugin, self).__init__()
+        self.config.add(
+            {
+                "categories": {},
+                "autoplay_on_track_change": False,
+                "autoplay_at_launch": False,
+                "autonext_at_track_end": False,
+                "autosave_on_quit": False,
+                "keep_playing_on_track_change_if_playing": True,
+            }
+        )
+
+    def commands(self):
+        cmd = ui.Subcommand(
+            "quicktag",
+            help="Quickly tag tracks with predefined options.",
+            aliases=["qt"],
+        )
+        cmd.func = self.run_quicktag
+        return [cmd]
+
+    def run_quicktag(self, lib: BeetsLibrary, opts: optparse.Values, args):
+        query = ui.decargs(args)
+        items: BeetsResults = lib.items(query)
+
+        if not items:
+            ui.print_("No tracks found to tag.")
+            return
+
+        categories_config = self.config["categories"].get(dict)
+        autoplay_on_track_change_enabled = self.config["autoplay_on_track_change"].get(
+            bool
+        )
+        autoplay_at_launch_enabled = self.config["autoplay_at_launch"].get(bool)
+        autonext_at_track_end_enabled = self.config["autonext_at_track_end"].get(bool)
+        autosave_on_quit_enabled = self.config["autosave_on_quit"].get(bool)
+        keep_playing_on_track_change_if_playing_enabled = self.config["keep_playing_on_track_change_if_playing"].get(bool)
+
+        if not categories_config:
+            ui.print_(
+                "No categories defined in the configuration. Please configure the quicktag plugin."
+            )
+            ui.print_("Example configuration:")
+            ui.print_("quicktag:")
+            ui.print_("  categories:")
+            ui.print_("    mood: [happy, sad, energetic, calm]")
+            ui.print_(
+                "    genre_custom: [electronic, ambient, experimental, soundtrack]"
+            )
+            return
+
+        categories = list(categories_config.items())
+
+        app = QuickTagApp(
+            lib,
+            items,
+            categories,
+            autoplay_on_track_change_enabled,
+            autoplay_at_launch_enabled,
+            autonext_at_track_end_enabled,
+            autosave_on_quit_enabled,
+            keep_playing_on_track_change_if_playing_enabled,
+        )
+        app.run()