Metadata-Version: 2.1
Name: dtv2
Version: 0.2.3
Summary: Some functions to handle color management on the Drevo Tyrfing V2
Home-page: https://twitter.com/david_cobac
Author: David COBAC
Author-email: david.cobac@gmail.com
License: CC-BY-NC-SA
Description: ## Installation
        
        1. Copy the ` 99-drevo-tyrfing.rules` in the `/etc/udev/rules.d/`
           directory to grant user with permissions for to send/write
           informations to the keyboard. Restart or `# udevadm trigger`.
        
        2. `pip3 install dtv2`
        
        3. (optional) Use `tyrfingcfg.py` script (in `exemples` directory)
           to change keys colors (whole keyboard, categories and/or just
           some keys) using svg color names. See examples at the end.
        
        ## Requirements
        
        `dtv2` needs `hidapi` library: `pip3 install hidapi`
        
        `tyrfingcfg.py` example script needs `colour` library: `pip3 install colour`
        
        
        ## Change colors: keyboard, category or key
        
        Python module to manage key color assignments on the Drevo Tyrfing
        v2 keyboard.
        
        ``` python3
        import dtv2
        my_kbd = dtv2.dtv2()
        my_kbd.change_kbd_color((0, 0, 0))
        my_kbd.change_cat_color("arrows", (0, 0x80, 0))
        my_kbd.change_key_color('esc', (0xff, 0, 0))
        ```
        
        ## key identifiers and command prefix found at
        
        [https://github.com/dennisblokland/DrevoTyrfing](https://github.com/dennisblokland/DrevoTyrfing)
        
        Nevertheless I noticed RGB preceeds spacer on the DTV2, so that the
        script send 31 bytes instead of 32.
        
        [USB hid tables](https://www.usb.org/sites/default/files/documents/hut1_12v2.pdf) (for missing french key codes) 
        
        ## example script
        
        The script `exemples/tyrfingcfg.py` shows how to use the module.
        
        Some config to try:
        
        `python3 tyrfingcfg.py -kbd white -cat letters green mod gold function red edition yellow digits gray arrows cyan -key space blue esc blue enter lightblue`
        
        
        `python3 tyrfingcfg.py -kbd black -cat letters gray`
        
        `python3 tyrfingcfg.py -kbd black -cat letters gray -key space gray enter gray tab gray`
        
        
        ## Thanks
        
        [Flozz](https://github.com/flozz)
        
        
Keywords: keyboard,drevo,tyrfing
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
