Merge branch 'release/0.4.0'

.gitignore

@@ -1,2 +1,12 @@
 *.pyc
 tmp/
+*.mp4
+*.ppm
+*.mmd
+documentation/
+roles/desktop/files/etc/xdg/menus/
+roles/desktop/files/usr/local/share/applications/
+roles/desktop/files/usr/local/share/desktop-directories/
+docs/example/playbooks/vars/Archlinux-i3.yml
+*.cast
+*.bz2

README.md

@@ -1,58 +1,6 @@
-# Ansible Collection - b08x.syncopated
+# Ansible Collection: Syncopated
 
-Documentation for the collection.
+The "Syncopated" Ansible collection contains roles, playbooks, and modules to help configure and manage Linux hosts that are part of an audio production workflow. This includes digital signal processing (DSP) servers as well as digital audio workstation (DAW) client machines.
 
-```yaml
-
-- hosts: localhost
-  become: True
-  gather_subset:
-    - hardware
-    - network
-
-  vars:
-    desktop:
-      wm: 'i3'
-      shell: 'zsh'
-      dm: greetd
-      terminal: 'terminator'
-      audio: 'jack'
-      ruby_version: 3.0.0
-      python_version: 3.11.1
-      applications:
-        ide:
-          - 'sonic-pi'
-          - 'pulsar'
-          - 'bipscript'
-        audio:
-          daw:
-            - 'reaper'
-            - 'bitwig'
-          plugins:
-            - 'swh-lv2'
-            - 'x42'
-            - 'zita'
-            - 'ambix'
-    path:
-      - "{{ lookup('env','HOME') }}/.local/bin"
-      # - /another/path/bin
-    cleanup: True
-
-  environment:
-    PATH: "{{ ansible_env.PATH }}:/sbin:/bin:{{ path|join(':') }}"
-    PKG_CONFIG_PATH: "/usr/share/pkgconfig:/usr/lib/pkgconfig:/usr/local/lib/pkgconfig"
-    ZSH: "/usr/share/oh-my-zsh"
-    DISPLAY: ":0"
-
-
-
-pre_tasks:
-
-roles:
-
-  - role: desktop
-    tags: ['desktop']
-
-
-
-```
+The collection aims to automate and simplify setting up the Linux infrastructure for professional audio production environments. It handles mundane system configuration to allow engineers to focus on their creative work. The consistent configurations aid collaboration between sound engineers when working across different
+studios and facilities.

ansible.cfg

@@ -16,7 +16,7 @@ stdout_callback         = yaml
 callbacks_enabled       = profile_tasks
 
 log_path                = /tmp/ansible.log
-ansible_managed         = 'Ansible took care of this file because you were too busy with your modular synthsizers to be bothered.'
+ansible_managed         = Ansible took care of this file because you were too busy with your modular synthsizers to be bothered.
 
 display_skipped_hosts   = False
 display_args_to_stdout  = False

bin/README.md

@@ -0,0 +1,48 @@
+# setting up a new host
+
+`bash <(curl http://github/b08x/syncopated/setup.sh)`
+
+* installs ansible & galaxy collection
+
+Feature: var files for each role are displayed for user to edit/change, 
+those variable are stored in ~/.config/syncopated/vars.yml
+
+```bash
+
+docker container of target distro with additional repos is started
+
+
+***select packages to install using gum or fzf***
+
+
+
+`prompt: select target distro`
+
+`prompt: add any additional repos`
+
+`prompt: add users`
+
+`prompt: select window manager`
+
+`prompt: edit/enter custom keybindings`
+
+`prompt: select audio subsystem: jack|pipewire`
+
+etc etc
+
+```
+
+Then when creating a playbook:
+
+```yaml
+
+- hosts: all
+  vars_files: ~/.config/syncopated/vars.yml
+
+- hosts: localhost
+  vars_files: ~/.config/syncopated/host_vars/hostname.yml
+
+- hosts: workstations
+  vars_files: ~/.config/syncopated/group_vars/workstations.yml
+
+```