Im Prozess des DEB-Building _ Versuch 1

kbdled-1.3/DEBIAN/control

@@ -0,0 +1,8 @@
+Package: kbdLED
+Version: 1.3.0
+Architecture: all
+Depends: python3 (>= 3.10), systemd (>= 250.0)
+Maintainer: devnull <debian@siningsoft.de>
+Description: An Application that controls the Keyboard LED and saves/restore settings durch shutdown and startup of one of the following Laptops: Clevo NL50CU/NL51CU, Wortmann Terra 1500P, Tuxedo Auro 15 Gen4, NovaCustom NL50/NL51 Serie, Schenker 15 Base. Check information on following page: [https://wiki.siningsoft.de/doku.php?id=terra:1500p], You'll also get a systemd unit-file which controls startup and shutdown, so that color and brightness settings will be saved on shutdown and restored during startup. Please ensure to install the apropriate kernel module from Tuxedo or NovaCustom [https://novacustom.com/de/clevo-rgb-tastatur-hintergrundbeleuchtung-in-linux/]. The Wiki gives all information.
+
+

kbdled-1.3/debian-binary

@@ -0,0 +1 @@
+2.0

kbdled-1.3/debian/README.Debian

@@ -0,0 +1,6 @@
+kbdled for Debian
+----------------
+
+<Possible notes regarding this package - if none, delete this file.>
+
+ -- devnull <debian@siningsoft.de>  Tue, 24 Feb 2026 23:03:41 +0100

kbdled-1.3/debian/README.source

@@ -0,0 +1,10 @@
+kbdled for Debian
+----------------
+
+<This file describes information about the source package, see Debian policy
+manual section 4.14. You WILL either need to modify or delete this file.>
+
+
+
+ -- devnull <debian@siningsoft.de>  Tue, 24 Feb 2026 23:03:41 +0100
+

kbdled-1.3/debian/changelog

@@ -0,0 +1,5 @@
+kbdled (1.3-1) UNRELEASED; urgency=medium
+
+  * Initial release. (Closes: #nnnn)  <nnnn is the bug number of your ITP>
+
+ -- devnull <debian@siningsoft.de>  Tue, 24 Feb 2026 23:03:41 +0100

kbdled-1.3/debian/control

@@ -0,0 +1,40 @@
+Source: kbdled
+Section: unknown
+Priority: optional
+Maintainer: devnull <debian@siningsoft.de>
+Rules-Requires-Root: no
+Build-Depends:
+ debhelper-compat (= 13),
+ dh-sequence-python3,
+ python3-setuptools,
+ python3-all,
+#Testsuite: autopkgtest-pkg-python
+Standards-Version: 4.6.2
+Homepage: <insert the upstream URL, if relevant>
+#Vcs-Browser: https://salsa.debian.org/debian/kbdled
+#Vcs-Git: https://salsa.debian.org/debian/kbdled.git
+
+Package: python3-kbdled
+Architecture: all
+Multi-Arch: foreign
+Depends:
+ ${python3:Depends},
+ ${misc:Depends},
+Suggests:
+ python-kbdled-doc,
+Description: <insert up to 60 chars description> (Python 3)
+ <Insert long description, indented with spaces.>
+ .
+ This package installs the library for Python 3.
+
+Package: python-kbdled-doc
+Section: doc
+Architecture: all
+Multi-Arch: foreign
+Depends:
+ ${sphinxdoc:Depends},
+ ${misc:Depends},
+Description: <insert up to 60 chars description> (common documentation)
+ <Insert long description, indented with spaces.>
+ .
+ This is the common documentation package.

kbdled-1.3/debian/copyright

@@ -0,0 +1,47 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Source: <url://example.com>
+Upstream-Name: kbdled
+Upstream-Contact: <preferred name and address to reach the upstream project>
+
+Files:
+ *
+Copyright:
+ <years> <put author's name and email here>
+ <years> <likewise for another author>
+License: <special license>
+ <Put the license of the package here indented by 1 space>
+ <This follows the format of Description: lines in control file>
+ .
+ <Including paragraphs>
+
+# If you want to use GPL v2 or later for the /debian/* files use
+# the following clauses, or change it to suit. Delete these two lines
+Files:
+ debian/*
+Copyright:
+ 2026 devnull <debian@siningsoft.de>
+License: GPL-2+
+ This package is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+ .
+ This package is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>
+Comment:
+ On Debian systems, the complete text of the GNU General
+ Public License version 2 can be found in "/usr/share/common-licenses/GPL-2".
+
+# Please also look if there are files or directories which have a
+# different copyright/license attached and list them here.
+# Please avoid picking licenses with terms that are more restrictive than the
+# packaged work, as it may make Debian's contributions unacceptable upstream.
+#
+# If you need, there are some extra license texts available in two places:
+#   /usr/share/debhelper/dh_make/licenses/
+#   /usr/share/common-licenses/

kbdled-1.3/debian/kbdled.cron.d.ex

@@ -0,0 +1,4 @@
+#
+# Regular cron jobs for the kbdled package.
+#
+0 4	* * *	root	[ -x /usr/bin/kbdled_maintenance ] && /usr/bin/kbdled_maintenance

kbdled-1.3/debian/kbdled.doc-base.ex

@@ -0,0 +1,20 @@
+Document: kbdled
+Title: Debian kbdled Manual
+Author: <insert document author here>
+Abstract: This manual describes what kbdled is
+ and how it can be used to
+ manage online manuals on Debian systems.
+Section: unknown
+
+Format: debiandoc-sgml
+Files: /usr/share/doc/kbdled/kbdled.sgml.gz
+
+Format: postscript
+Files: /usr/share/doc/kbdled/kbdled.ps.gz
+
+Format: text
+Files: /usr/share/doc/kbdled/kbdled.text.gz
+
+Format: HTML
+Index: /usr/share/doc/kbdled/html/index.html
+Files: /usr/share/doc/kbdled/html/*.html

kbdled-1.3/debian/manpage.1.ex

@@ -0,0 +1,56 @@
+.\"                                      Hey, EMACS: -*- nroff -*-
+.\" (C) Copyright 2026 devnull <debian@siningsoft.de>,
+.\"
+.\" First parameter, NAME, should be all caps
+.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
+.\" other parameters are allowed: see man(7), man(1)
+.TH Kbdled SECTION "February 24 2026"
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.SH NAME
+kbdled \- program to do something
+.SH SYNOPSIS
+.B kbdled
+.RI [ options ] " files" ...
+.br
+.B bar
+.RI [ options ] " files" ...
+.SH DESCRIPTION
+This manual page documents briefly the
+.B kbdled
+and
+.B bar
+commands.
+.PP
+.\" TeX users may be more comfortable with the \fB<whatever>\fP and
+.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
+.\" respectively.
+\fBkbdled\fP is a program that...
+.SH OPTIONS
+These programs follow the usual GNU command line syntax, with long
+options starting with two dashes ('\-').
+A summary of options is included below.
+For a complete description, see the Info files.
+.TP
+.B \-h, \-\-help
+Show summary of options.
+.TP
+.B \-v, \-\-version
+Show version of program.
+.SH SEE ALSO
+.BR bar (1),
+.BR baz (1).
+.br
+The programs are documented fully by
+.IR "The Rise and Fall of a Fooish Bar" ,
+available via the Info system.

kbdled-1.3/debian/manpage.md.ex

@@ -0,0 +1,134 @@
+% kbdled(SECTION) | User Commands
+%
+% "February 24 2026"
+
+[comment]: # The lines above form a Pandoc metadata block. They must be
+[comment]: # the first ones in the file.
+[comment]: # See https://pandoc.org/MANUAL.html#metadata-blocks for details.
+
+[comment]: # pandoc -s -f markdown -t man package.md -o package.1
+[comment]: # 
+[comment]: # A manual page package.1 will be generated. You may view the
+[comment]: # manual page with: nroff -man package.1 | less. A typical entry
+[comment]: # in a Makefile or Makefile.am is:
+[comment]: # 
+[comment]: # package.1: package.md
+[comment]: #         pandoc --standalone --from=markdown --to=man $< --output=$@
+[comment]: # 
+[comment]: # The pandoc binary is found in the pandoc package. Please remember
+[comment]: # that if you create the nroff version in one of the debian/rules
+[comment]: # file targets, such as build, you will need to include pandoc in
+[comment]: # your Build-Depends control field.
+
+[comment]: # lowdown is a low dependency, lightweight alternative to
+[comment]: # pandoc as a markdown to manpage translator. Use with:
+[comment]: # 
+[comment]: # package.1: package.md
+[comment]: #         lowdown -s -Tman -o $@ $<
+[comment]: # 
+[comment]: # And add lowdown to the Build-Depends control field.
+
+[comment]: # Remove the lines starting with '[comment]:' in this file in order
+[comment]: # to avoid warning messages.
+
+# NAME
+
+kbdled - program to do something
+
+# SYNOPSIS
+
+**kbdled** **-e** _this_ [**\-\-example=that**] [{**-e** | **\-\-example**} _this_]
+                 [{**-e** | **\-\-example**} {_this_ | _that_}]
+
+**kbdled** [{**-h** | *\-\-help**} | {**-v** | **\-\-version**}]
+
+# DESCRIPTION
+
+This manual page documents briefly the **kbdled** and **bar** commands.
+
+This manual page was written for the Debian distribution because the
+original program does not have a manual page. Instead, it has documentation
+in the GNU info(1) format; see below.
+
+**kbdled** is a program that...
+
+# OPTIONS
+
+The program follows the usual GNU command line syntax, with long options
+starting with two dashes ('-'). A summary of options is included below. For
+a complete description, see the **info**(1) files.
+
+**-e** _this_, **\-\-example=**_that_
+:   Does this and that.
+
+**-h**, **\-\-help**
+:   Show summary of options.
+
+**-v**, **\-\-version**
+:   Show version of program.
+
+# FILES
+
+/etc/foo.conf
+:   The system-wide configuration file to control the behaviour of
+    kbdled. See **foo.conf**(5) for further details.
+
+${HOME}/.foo.conf
+:   The per-user configuration file to control the behaviour of
+    kbdled. See **foo.conf**(5) for further details.
+
+# ENVIRONMENT
+
+**FOO_CONF**
+:   If used, the defined file is used as configuration file (see also
+    the section called “FILES”).
+
+# DIAGNOSTICS
+
+The following diagnostics may be issued on stderr:
+
+Bad configuration file. Exiting.
+:   The configuration file seems to contain a broken configuration
+    line. Use the **\-\-verbose** option, to get more info.
+
+**kbdled** provides some return codes, that can be used in scripts:
+
+    Code Diagnostic
+    0 Program exited successfully.
+    1 The configuration file seems to be broken.
+
+# BUGS
+
+The program is currently limited to only work with the foobar library.
+
+The upstream BTS can be found at http://bugzilla.foo.tld.
+
+# SEE ALSO
+
+**bar**(1), **baz**(1), **foo.conf**(5)
+
+The programs are documented fully by The Rise and Fall of a Fooish Bar
+available via the **info**(1) system.
+
+# AUTHOR
+
+devnull <debian@siningsoft.de>
+:   Wrote this manpage for the Debian system.
+
+# COPYRIGHT
+
+Copyright © 2007 devnull
+
+This manual page was written for the Debian system (and may be used by
+others).
+
+Permission is granted to copy, distribute and/or modify this document under
+the terms of the GNU General Public License, Version 2 or (at your option)
+any later version published by the Free Software Foundation.
+
+On Debian systems, the complete text of the GNU General Public License
+can be found in /usr/share/common-licenses/GPL.
+
+[comment]: #  Local Variables:
+[comment]: #  mode: markdown
+[comment]: #  End:

kbdled-1.3/debian/manpage.sgml.ex

@@ -0,0 +1,154 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+     page: 'docbook-to-man manpage.sgml > manpage.1'.  You may view
+     the manual page with: 'docbook-to-man manpage.sgml | nroff -man |
+     less'.  A typical entry in a Makefile or Makefile.am is:
+
+manpage.1: manpage.sgml
+	docbook-to-man $< > $@
+
+
+	The docbook-to-man binary is found in the docbook-to-man package.
+	Please remember that if you create the nroff version in one of the
+	debian/rules file targets (such as build), you will need to include
+	docbook-to-man in your Build-Depends control field.
+
+  -->
+
+  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
+  <!ENTITY dhfirstname "<firstname>FIRSTNAME</firstname>">
+  <!ENTITY dhsurname   "<surname>SURNAME</surname>">
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY dhdate      "<date>February 24 2026</date>">
+  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
+       allowed: see man(7), man(1). -->
+  <!ENTITY dhsection   "<manvolnum>SECTION</manvolnum>">
+  <!ENTITY dhemail     "<email>debian@siningsoft.de</email>">
+  <!ENTITY dhusername  "devnull">
+  <!ENTITY dhucpackage "<refentrytitle>Kbdled</refentrytitle>">
+  <!ENTITY dhpackage   "kbdled">
+
+  <!ENTITY debian      "<productname>Debian</productname>">
+  <!ENTITY gnu         "<acronym>GNU</acronym>">
+  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
+]>
+
+<refentry>
+  <refentryinfo>
+    <address>
+      &dhemail;
+    </address>
+    <author>
+      &dhfirstname;
+      &dhsurname;
+    </author>
+    <copyright>
+      <year>2003</year>
+      <holder>&dhusername;</holder>
+    </copyright>
+    &dhdate;
+  </refentryinfo>
+  <refmeta>
+    &dhucpackage;
+
+    &dhsection;
+  </refmeta>
+  <refnamediv>
+    <refname>&dhpackage;</refname>
+
+    <refpurpose>program to do something</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+
+      <arg><option>-e <replaceable>this</replaceable></option></arg>
+
+      <arg><option>--example <replaceable>that</replaceable></option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+
+    <para>This manual page documents briefly the
+      <command>&dhpackage;</command> and <command>bar</command>
+      commands.</para>
+
+    <para>This manual page was written for the &debian; distribution
+      because the original program does not have a manual page.
+      Instead, it has documentation in the &gnu;
+      <application>Info</application> format; see below.</para>
+
+    <para><command>&dhpackage;</command> is a program that...</para>
+
+  </refsect1>
+  <refsect1>
+    <title>OPTIONS</title>
+
+    <para>These programs follow the usual &gnu; command line syntax,
+      with long options starting with two dashes ('-').  A summary of
+      options is included below.  For a complete description, see the
+      <application>Info</application> files.</para>
+
+    <variablelist>
+      <varlistentry>
+        <term><option>-h</option>
+          <option>--help</option>
+        </term>
+        <listitem>
+          <para>Show summary of options.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-v</option>
+          <option>--version</option>
+        </term>
+        <listitem>
+          <para>Show version of program.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1>
+    <title>SEE ALSO</title>
+
+    <para>bar (1), baz (1).</para>
+
+    <para>The programs are documented fully by <citetitle>The Rise and
+      Fall of a Fooish Bar</citetitle> available via the
+      <application>Info</application> system.</para>
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>This manual page was written by &dhusername; &dhemail; for
+      the &debian; system (and may be used by others).  Permission is
+      granted to copy, distribute and/or modify this document under
+      the terms of the &gnu; General Public License, Version 2 any
+      later version published by the Free Software Foundation.
+    </para>
+    <para>
+      On Debian systems, the complete text of the GNU General Public
+      License can be found in /usr/share/common-licenses/GPL.
+    </para>
+
+  </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->

kbdled-1.3/debian/manpage.xml.ex

@@ -0,0 +1,291 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+
+<!--
+
+`xsltproc -''-nonet \
+          -''-param man.charmap.use.subset "0" \
+          -''-param make.year.ranges "1" \
+          -''-param make.single.year.ranges "1" \
+          /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl \
+          manpage.xml`
+
+A manual page <package>.<section> will be generated. You may view the
+manual page with: nroff -man <package>.<section> | less'. A typical entry
+in a Makefile or Makefile.am is:
+
+DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/docbook-xsl/manpages/docbook.xsl
+XP     = xsltproc -''-nonet -''-param man.charmap.use.subset "0"
+
+manpage.1: manpage.xml
+        $(XP) $(DB2MAN) $<
+
+The xsltproc binary is found in the xsltproc package. The XSL files are in
+docbook-xsl. A description of the parameters you can use can be found in the
+docbook-xsl-doc-* packages. Please remember that if you create the nroff
+version in one of the debian/rules file targets (such as build), you will need
+to include xsltproc and docbook-xsl in your Build-Depends control field.
+Alternatively use the xmlto command/package. That will also automatically
+pull in xsltproc and docbook-xsl.
+
+Notes for using docbook2x: docbook2x-man does not automatically create the
+AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as
+<refsect1> ... </refsect1>.
+
+To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections
+read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be
+found in the docbook-xsl-doc-html package.
+
+Validation can be done using: `xmllint -''-noout -''-valid manpage.xml`
+
+General documentation about man-pages and man-page-formatting:
+man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
+
+-->
+
+  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
+  <!ENTITY dhfirstname "FIRSTNAME">
+  <!ENTITY dhsurname   "SURNAME">
+  <!-- dhusername could also be set to "&dhfirstname; &dhsurname;". -->
+  <!ENTITY dhusername  "devnull">
+  <!ENTITY dhemail     "debian@siningsoft.de">
+  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
+       allowed: see man(7), man(1) and
+       http://www.tldp.org/HOWTO/Man-Page/q2.html. -->
+  <!ENTITY dhsection   "SECTION">
+  <!-- TITLE should be something like "User commands" or similar (see
+       http://www.tldp.org/HOWTO/Man-Page/q2.html). -->
+  <!ENTITY dhtitle     "kbdled User Manual">
+  <!ENTITY dhucpackage "Kbdled">
+  <!ENTITY dhpackage   "kbdled">
+]>
+
+<refentry>
+  <refentryinfo>
+    <title>&dhtitle;</title>
+    <productname>&dhpackage;</productname>
+    <authorgroup>
+      <author>
+       <firstname>&dhfirstname;</firstname>
+        <surname>&dhsurname;</surname>
+        <contrib>Wrote this manpage for the Debian system.</contrib>
+        <address>
+          <email>&dhemail;</email>
+        </address>
+      </author>
+    </authorgroup>
+    <copyright>
+      <year>2007</year>
+      <holder>&dhusername;</holder>
+    </copyright>
+    <legalnotice>
+      <para>This manual page was written for the Debian system
+        (and may be used by others).</para>
+      <para>Permission is granted to copy, distribute and/or modify this
+        document under the terms of the GNU General Public License,
+        Version 2 or (at your option) any later version published by
+        the Free Software Foundation.</para>
+      <para>On Debian systems, the complete text of the GNU General Public
+        License can be found in
+        <filename>/usr/share/common-licenses/GPL</filename>.</para>
+    </legalnotice>
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>&dhucpackage;</refentrytitle>
+    <manvolnum>&dhsection;</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>&dhpackage;</refname>
+    <refpurpose>program to do something</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+      <!-- These are several examples, how syntaxes could look -->
+      <arg choice="plain"><option>-e <replaceable>this</replaceable></option></arg>
+      <arg choice="opt"><option>--example=<parameter>that</parameter></option></arg>
+      <arg choice="opt">
+        <group choice="req">
+          <arg choice="plain"><option>-e</option></arg>
+          <arg choice="plain"><option>--example</option></arg>
+        </group>
+        <replaceable class="option">this</replaceable>
+      </arg>
+      <arg choice="opt">
+        <group choice="req">
+          <arg choice="plain"><option>-e</option></arg>
+          <arg choice="plain"><option>--example</option></arg>
+        </group>
+        <group choice="req">
+          <arg choice="plain"><replaceable>this</replaceable></arg>
+          <arg choice="plain"><replaceable>that</replaceable></arg>
+        </group>
+      </arg>
+    </cmdsynopsis>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+      <!-- Normally the help and version options make the programs stop
+           right after outputting the requested information. -->
+      <group choice="opt">
+        <arg choice="plain">
+          <group choice="req">
+            <arg choice="plain"><option>-h</option></arg>
+            <arg choice="plain"><option>--help</option></arg>
+          </group>
+        </arg>
+        <arg choice="plain">
+          <group choice="req">
+            <arg choice="plain"><option>-v</option></arg>
+            <arg choice="plain"><option>--version</option></arg>
+          </group>
+        </arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1 id="description">
+    <title>DESCRIPTION</title>
+    <para>This manual page documents briefly the
+      <command>&dhpackage;</command> and <command>bar</command>
+      commands.</para>
+    <para>This manual page was written for the Debian distribution
+      because the original program does not have a manual page.
+      Instead, it has documentation in the GNU <citerefentry>
+        <refentrytitle>info</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry> format; see below.</para>
+    <para><command>&dhpackage;</command> is a program that...</para>
+  </refsect1>
+  <refsect1 id="options">
+    <title>OPTIONS</title>
+    <para>The program follows the usual GNU command line syntax,
+      with long options starting with two dashes ('-').  A summary of
+      options is included below.  For a complete description, see the
+      <citerefentry>
+        <refentrytitle>info</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry> files.</para>
+    <variablelist>
+      <!-- Use the variablelist.term.separator and the
+           variablelist.term.break.after parameters to
+           control the term elements. -->
+      <varlistentry>
+        <term><option>-e <replaceable>this</replaceable></option></term>
+        <term><option>--example=<replaceable>that</replaceable></option></term>
+        <listitem>
+          <para>Does this and that.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-h</option></term>
+        <term><option>--help</option></term>
+        <listitem>
+          <para>Show summary of options.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-v</option></term>
+        <term><option>--version</option></term>
+        <listitem>
+          <para>Show version of program.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1 id="files">
+    <title>FILES</title>
+    <variablelist>
+      <varlistentry>
+        <term><filename>/etc/foo.conf</filename></term>
+        <listitem>
+          <para>The system-wide configuration file to control the
+            behaviour of <application>&dhpackage;</application>. See
+            <citerefentry>
+              <refentrytitle>foo.conf</refentrytitle>
+              <manvolnum>5</manvolnum>
+            </citerefentry> for further details.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>${HOME}/.foo.conf</filename></term>
+        <listitem>
+          <para>The per-user configuration file to control the
+             behaviour of <application>&dhpackage;</application>. See
+             <citerefentry>
+               <refentrytitle>foo.conf</refentrytitle>
+               <manvolnum>5</manvolnum>
+             </citerefentry> for further details.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1 id="environment">
+    <title>ENVIRONMENT</title>
+    <variablelist>
+      <varlistentry>
+        <term><envar>FOO_CONF</envar></term>
+        <listitem>
+          <para>If used, the defined file is used as configuration
+            file (see also <xref linkend="files"/>).</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+  <refsect1 id="diagnostics">
+    <title>DIAGNOSTICS</title>
+    <para>The following diagnostics may be issued
+      on <filename class="devicefile">stderr</filename>:</para>
+    <variablelist>
+      <varlistentry>
+        <term><errortext>Bad configuration file. Exiting.</errortext></term>
+        <listitem>
+          <para>The configuration file seems to contain a broken configuration
+            line. Use the <option>--verbose</option> option, to get more info.
+          </para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    <para><command>&dhpackage;</command> provides some return codes, that can
+      be used in scripts:</para>
+    <segmentedlist>
+      <segtitle>Code</segtitle>
+      <segtitle>Diagnostic</segtitle>
+      <seglistitem>
+        <seg><errorcode>0</errorcode></seg>
+        <seg>Program exited successfully.</seg>
+      </seglistitem>
+      <seglistitem>
+        <seg><errorcode>1</errorcode></seg>
+        <seg>The configuration file seems to be broken.</seg>
+      </seglistitem>
+    </segmentedlist>
+  </refsect1>
+  <refsect1 id="bugs">
+    <!-- Or use this section to tell about upstream BTS. -->
+    <title>BUGS</title>
+    <para>The program is currently limited to only work
+      with the <package>foobar</package> library.</para>
+    <para>The upstreams <acronym>BTS</acronym> can be found
+      at <ulink url="http://bugzilla.foo.tld"/>.</para>
+  </refsect1>
+  <refsect1 id="see_also">
+    <title>SEE ALSO</title>
+    <!-- In alpabetical order. -->
+    <para><citerefentry>
+        <refentrytitle>bar</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>, <citerefentry>
+        <refentrytitle>baz</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry>, <citerefentry>
+        <refentrytitle>foo.conf</refentrytitle>
+        <manvolnum>5</manvolnum>
+      </citerefentry></para>
+    <para>The programs are documented fully by <citetitle>The Rise and
+      Fall of a Fooish Bar</citetitle> available via the <citerefentry>
+        <refentrytitle>info</refentrytitle>
+        <manvolnum>1</manvolnum>
+      </citerefentry> system.</para>
+  </refsect1>
+</refentry>
+

kbdled-1.3/debian/postinst.ex

@@ -0,0 +1,39 @@
+#!/bin/sh
+# postinst script for kbdled.
+#
+# See: dh_installdeb(1).
+
+set -e
+
+# Summary of how this script can be called:
+#        * <postinst> 'configure' <most-recently-configured-version>
+#        * <old-postinst> 'abort-upgrade' <new version>
+#        * <conflictor's-postinst> 'abort-remove' 'in-favour' <package>
+#          <new-version>
+#        * <postinst> 'abort-remove'
+#        * <deconfigured's-postinst> 'abort-deconfigure' 'in-favour'
+#          <failed-install-package> <version> 'removing'
+#          <conflicting-package> <version>
+# for details, see https://www.debian.org/doc/debian-policy/ or
+# the debian-policy package.
+
+
+case "$1" in
+    configure)
+    ;;
+
+    abort-upgrade|abort-remove|abort-deconfigure)
+    ;;
+
+    *)
+        echo "postinst called with unknown argument '$1'" >&2
+        exit 1
+    ;;
+esac
+
+# dh_installdeb will replace this with shell code automatically
+# generated by other debhelper scripts.
+
+#DEBHELPER#
+
+exit 0

kbdled-1.3/debian/postrm.ex

@@ -0,0 +1,37 @@
+#!/bin/sh
+# postrm script for kbdled.
+#
+# See: dh_installdeb(1).
+
+set -e
+
+# Summary of how this script can be called:
+#        * <postrm> 'remove'
+#        * <postrm> 'purge'
+#        * <old-postrm> 'upgrade' <new-version>
+#        * <new-postrm> 'failed-upgrade' <old-version>
+#        * <new-postrm> 'abort-install'
+#        * <new-postrm> 'abort-install' <old-version>
+#        * <new-postrm> 'abort-upgrade' <old-version>
+#        * <disappearer's-postrm> 'disappear' <overwriter>
+#          <overwriter-version>
+# for details, see https://www.debian.org/doc/debian-policy/ or
+# the debian-policy package.
+
+
+case "$1" in
+    purge|remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)
+    ;;
+
+    *)
+        echo "postrm called with unknown argument '$1'" >&2
+        exit 1
+    ;;
+esac
+
+# dh_installdeb will replace this with shell code automatically
+# generated by other debhelper scripts.
+
+#DEBHELPER#
+
+exit 0

kbdled-1.3/debian/preinst.ex

@@ -0,0 +1,35 @@
+#!/bin/sh
+# preinst script for kbdled.
+#
+# See: dh_installdeb(1).
+
+set -e
+
+# Summary of how this script can be called:
+#        * <new-preinst> 'install'
+#        * <new-preinst> 'install' <old-version>
+#        * <new-preinst> 'upgrade' <old-version>
+#        * <old-preinst> 'abort-upgrade' <new-version>
+# for details, see https://www.debian.org/doc/debian-policy/ or
+# the debian-policy package.
+
+
+case "$1" in
+    install|upgrade)
+    ;;
+
+    abort-upgrade)
+    ;;
+
+    *)
+        echo "preinst called with unknown argument '$1'" >&2
+        exit 1
+    ;;
+esac
+
+# dh_installdeb will replace this with shell code automatically
+# generated by other debhelper scripts.
+
+#DEBHELPER#
+
+exit 0

kbdled-1.3/debian/prerm.ex

@@ -0,0 +1,38 @@
+#!/bin/sh
+# prerm script for kbdled.
+#
+# See: dh_installdeb(1).
+
+set -e
+
+# Summary of how this script can be called:
+#        * <prerm> 'remove'
+#        * <old-prerm> 'upgrade' <new-version>
+#        * <new-prerm> 'failed-upgrade' <old-version>
+#        * <conflictor's-prerm> 'remove' 'in-favour' <package> <new-version>
+#        * <deconfigured's-prerm> 'deconfigure' 'in-favour'
+#          <package-being-installed> <version> 'removing'
+#          <conflicting-package> <version>
+# for details, see https://www.debian.org/doc/debian-policy/ or
+# the debian-policy package.
+
+
+case "$1" in
+    remove|upgrade|deconfigure)
+    ;;
+
+    failed-upgrade)
+    ;;
+
+    *)
+        echo "prerm called with unknown argument '$1'" >&2
+        exit 1
+    ;;
+esac
+
+# dh_installdeb will replace this with shell code automatically
+# generated by other debhelper scripts.
+
+#DEBHELPER#
+
+exit 0

kbdled-1.3/debian/python-kbdled-doc.docs

@@ -0,0 +1,2 @@
+README.Debian
+README.source

kbdled-1.3/debian/rules

@@ -0,0 +1,23 @@
+#!/usr/bin/make -f
+
+# See debhelper(7) (uncomment to enable).
+# Output every command that modifies files on the build system.
+#export DH_VERBOSE = 1
+
+export PYBUILD_NAME=kbdled
+
+%:
+	dh $@ --buildsystem=pybuild
+
+
+# If you need to rebuild the Sphinx documentation:
+# Add sphinxdoc to the dh --with line.
+#
+# And uncomment the following lines.
+#execute_after_dh_auto_build-indep: export http_proxy=127.0.0.1:9
+#execute_after_dh_auto_build-indep: export https_proxy=127.0.0.1:9
+#execute_after_dh_auto_build-indep:
+#	PYTHONPATH=. python3 -m sphinx -N -bhtml \
+#	docs/ build/html # HTML generator
+#	PYTHONPATH=. python3 -m sphinx -N -bman \
+#	docs/ build/man # Manpage generator

kbdled-1.3/debian/salsa-ci.yml.ex

@@ -0,0 +1,10 @@
+# For more information on what jobs are run see:
+# https://salsa.debian.org/salsa-ci-team/pipeline
+#
+# To enable the jobs, go to your repository (at salsa.debian.org)
+# and click over Settings > CI/CD > Expand (in General pipelines).
+# In "CI/CD configuration file" write debian/salsa-ci.yml and click
+# in "Save Changes". The CI tests will run after the next commit.
+---
+include:
+  - https://salsa.debian.org/salsa-ci-team/pipeline/raw/master/recipes/debian.yml

kbdled-1.3/debian/source/format

@@ -0,0 +1 @@
+3.0 (quilt)

kbdled-1.3/debian/source/options

@@ -0,0 +1 @@
+extend-diff-ignore = "^[^/]*[.]egg-info/"

kbdled-1.3/debian/upstream/metadata.ex

@@ -0,0 +1,10 @@
+# Example file for upstream/metadata.
+# See https://wiki.debian.org/UpstreamMetadata for more info/fields.
+# Below an example based on a github project.
+
+# Bug-Database: https://github.com/<user>/kbdled/issues
+# Bug-Submit: https://github.com/<user>/kbdled/issues/new
+# Changelog: https://github.com/<user>/kbdled/blob/master/CHANGES
+# Documentation: https://github.com/<user>/kbdled/wiki
+# Repository-Browse: https://github.com/<user>/kbdled
+# Repository: https://github.com/<user>/kbdled.git

kbdled-1.3/debian/watch.ex

@@ -0,0 +1,37 @@
+# Example watch control file for uscan.
+# Rename this file to "watch" and then you can run the "uscan" command
+# to check for upstream updates and more.
+# See uscan(1) for format.
+
+# Compulsory line, this is a version 4 file.
+version=4
+
+# PGP signature mangle, so foo.tar.gz has foo.tar.gz.sig.
+#opts="pgpsigurlmangle=s%$%.sig%"
+
+# HTTP site (basic).
+#http://example.com/downloads.html \
+#    files/kbdled-([\d\.]+)\.tar\.gz
+
+# Uncomment to examine an FTP server.
+#ftp://ftp.example.com/pub/kbdled-(.*)\.tar\.gz
+
+# SourceForge hosted projects.
+#http://sf.net/kbdled/ kbdled-(.*)\.tar\.gz
+
+# GitHub hosted projects.
+#opts="filenamemangle=s%(?:.*?)?v?(@ANY_VERSION@@ARCHIVE_EXT@)%@PACKAGE@-$1%" \
+#    https://github.com/<user>/<project>/tags \
+#    (?:.*?/)v?@ANY_VERSION@@ARCHIVE_EXT@
+
+# GitLab hosted projects.
+#opts="filenamemangle=s%(?:.*?)?v?(@ANY_VERSION@@ARCHIVE_EXT@)%@PACKAGE@-$1%" \
+#    https://gitlab.com/<user>/<project>/-/tags \
+#    archive/v?@ANY_VERSION@/<project>-v?\d\S*@ARCHIVE_EXT@
+
+# PyPI.
+#https://pypi.debian.net/kbdled/kbdled-(.+)\.(?:zip|tgz|tbz|txz|(?:tar\.(?:gz|bz2|xz)))
+
+# Direct Git.
+#opts="mode=git" http://git.example.com/kbdled.git \
+#    refs/tags/v([\d\.]+)

kbdled-1.3/usr/bin/kbdLED

@@ -0,0 +1,278 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+from enum import Enum, StrEnum
+
+# reads and writes RGB and brightness data for led background color of Clevo NL51 Laptops
+# ensure to compile drivers before ! read: https://wiki.siningsoft.de/doku.php?id=terra:1500p
+# Kernelmodul: tuxedo_keyboard
+
+# 2026-02-02 - devnull - initial
+# 2026-02-03 - devnull - added Brightness restore
+# 2026-02-04 - devnull - JSON statefile
+# 2026-02-11 - devnull - created class
+# 2026-02-18 - devnull - added logging
+# 2026-02-19 - devnull - added commandline arguments for changing
+# 2026-02-21 - devnull - color and brightness switching on commandline
+# 2026-02-21 - devnull - enable/disable LED via Commandline
+
+ver="1.4"
+
+import sys
+import argparse
+import json
+import logging
+
+# start with a logger object
+log = logging.getLogger(__name__)
+
+class kbdLED_class():
+
+    # 2026-02-11 - devnull  - added class definition
+    # 2026-02-19 - devnull  - bugfixed write procedure
+    #                       - added hard coded colors
+
+    class colors(StrEnum):
+        GREEN = "0 255 0"
+        WHITE = "255 255 255"
+        RED = "255 0 0"
+        BLUE = "0 0 255"
+        YELLOW = "255 255 0"
+        PURPLE = "255 0 255"
+        LIGHTBLUE = "0 0 255"
+
+        # d_GREEN = {"R":0,"G": 255,"B": 0}
+        # d_WHITE = {"R":255,"G": 255,"B": 255}
+        # d_RED = {"R":255,"G": 0,"B": 0}
+        # d_BLUE = {"R":0,"G": 0,"B": 255}
+        # d_YELLOW = {"R":255,"G": 255,"B": 0}
+        # d_PURPLE = {"R":255,"G": 0,"B": 255}
+        # d_LIGHTBLUE = {"R":0,"G": 255,"B": 255}
+
+    # diese Versionsnummer wird getrennt vom Programmcode geführt, da es sich getrennt entwickeln wird
+    __version__ = 1.1
+    config = dict()
+
+    # Objekt erzeugen
+    def __init__(self, cmd,
+                        log,
+                        INcolor=colors.WHITE,
+                        INbrightness=255,
+                        kbd_state_fp='/var/lib/kbdLED.state.json',
+                        sysfs_color_fp='/sys/devices/platform/tuxedo_keyboard/leds/rgb:kbd_backlight/multi_intensity',
+                        sysfs_bri_fp='/sys/devices/platform/tuxedo_keyboard/leds/rgb:kbd_backlight/brightness'):
+
+        self.log = log
+        self.config = {"sysfs" :
+                           {
+                                "color" : sysfs_color_fp ,
+                                "bri" : sysfs_bri_fp
+                           },
+                       "state" : kbd_state_fp}
+
+        self.log.debug(str(self.config))
+
+        # startup and restore states
+        if cmd=="start":
+            self.readStateFile(self.config['state'])
+            self.log.debug(str(self.config))
+            self.writeColor()
+            self.writeBrightness()
+
+        # shutdown system and save last states
+        elif cmd=="stop":
+            self.readColor()
+            self.readBrightness()
+            self.writeStateFile(self.config['state'])
+
+        # set the color from commandline
+        elif cmd=="color":
+            self.log.debug("INcolor=" + str(INcolor))
+            self.color2dict2config(INcolor)
+
+            self.log.debug("__init__(cmd=color).config['color']=" + str(self.config['color']))
+            self.writeColor()
+
+        # set the brightness from commandline
+        elif cmd=="brightness":
+            self.config['Brightness']= int(INbrightness)
+            self.writeBrightness()
+
+    def readStateFile(self,kbd_state_fp):
+
+        config = {"color":
+                      {"R": 255,
+                       "G": 255,
+                       "B": 255},
+                  "Brightness": 255
+                  }
+
+        try:
+            with open(kbd_state_fp, 'r') as kbd_state_fh:
+                self.config = json.load(kbd_state_fh)
+
+        except FileNotFoundError:
+            self.log.error("keine Statusdatei gefunden, nutze Standardwerte")
+        except PermissionError:
+            self.log.error("Fehler beim lesen")
+
+    def writeStateFile(self,kbd_state_fp):
+        try:
+            with open(kbd_state_fp, 'w') as kbd_state_fh:
+                json.dump(self.config,kbd_state_fh)
+
+        except FileNotFoundError:
+            self.log.error("Verzeichnis oder Datei nicht gefunden")
+
+    # color String nach Config Dict
+    def color2dict2config(self, color_string):
+        ca=color_string.split(" ")
+        self.log.debug("color_string=" + color_string)
+        self.log.debug("after splitting=" + str(ca))
+        self.config['color'] = {"R": int(ca[0]),
+                       "G": int(ca[1]),
+                       "B": int(ca[2])}
+
+    # color Confi Dict nach String
+    def config2dict2color(self):
+        return str(self.config['color']['R']) + " " + str(self.config['color']['G']) + " " + str(self.config['color']['B'])
+
+    # reads the color Values from sysfs
+    def readColor(self):
+        try:
+            with open(self.config['sysfs']['color']) as fh:
+                self.color2dict2config(fh.read())
+
+        except FileNotFoundError:
+            self.log.error("fehler beim Öffnen der Sysfs Datei " + self.config['sysfs']['color'])
+            sys.exit(1)
+        except PermissionError:
+            self.log.error("keine Rechte die Datei zu lesen " + self.config['sysfs']['color'])
+            sys.exit(1)
+
+
+    # writes the color values to sysfs
+    def writeColor(self):
+        try:
+            #with open(self.config['sysfs']['color']) as fh:
+            #    fh.write(self.dict2color())
+            fh = open(self.config['sysfs']['color'], 'w')
+            fh.write(self.config2dict2color())
+            fh.close()
+
+        except FileNotFoundError:
+            self.log.error("fehler beim Schreiben der Sysfs Datei " + self.config['sysfs']['color'])
+            sys.exit(1)
+
+        except PermissionError:
+            self.log.error("keine Rechte die Datei zu schreiben " + self.config['sysfs']['color'])
+            sys.exit(1)
+
+    # reads Brightness from sysfs
+    def readBrightness(self):
+        try:
+            with open(self.config['sysfs']['bri']) as fh:
+                self.config['Brightness'] = int(fh.read())
+
+        except FileNotFoundError:
+            self.log.error("fehler beim Öffnen der Sysfs Datei " + self.config['sysfs']['bri'])
+            sys.exit(1)
+        except PermissionError:
+            self.log.error("keine Rechte die Datei zu lesen " + self.config['sysfs']['bri'])
+            sys.exit(1)
+
+    # writes Brightness to sysfs
+    def writeBrightness(self):
+        try:
+            #with open(self.config['sysfs']['bri']) as fh:
+            #    fh.write(self.config['Brightness'])
+            fh = open(self.config['sysfs']['bri'], 'w')
+            fh.write(str(self.config['Brightness']))
+            fh.close()
+
+        except FileNotFoundError:
+            self.log.error("- fehler beim Schreiben der Sysfs Datei " + self.config['sysfs']['bri'])
+            sys.exit(1)
+        except PermissionError:
+            self.log.error("- keine Rechte die Datei zu schreiben " + self.config['sysfs']['bri'])
+            sys.exit(1)
+
+
+# Press the green button in the gutter to run the script.
+# noinspection aK
+if __name__ == '__main__':
+
+    #https: // argparse.readthedocs.io
+    # internal note: um mehrere sich ausschließende Argumente zuzulassen, muss add_mutually_exclusive_groups verwenden
+    parser = argparse.ArgumentParser(
+                    prog='T1500_KeyboardLED',
+                    description='saves and restore LED Colors',
+                    epilog='GPL')
+
+    group_common = parser.add_argument_group("common")
+    output = group_common.add_mutually_exclusive_group(required=False)
+    output.add_argument('--verbose', action='store_true', help='extended logging', required=False)
+    output.add_argument('--debug', action='store_true', help='debug output', required=False)
+
+    group_function = parser.add_argument_group("function")
+    startstop = group_function.add_mutually_exclusive_group()
+    startstop.add_argument('--on', action='store_true', help='generally turn LED Backlight on')
+    startstop.add_argument('--off', action='store_true', help='generally turn LED Backlight off')
+    startstop.add_argument('--start', action='store_true', help='will be used for system starts')
+    startstop.add_argument('--stop', action='store_true', help='will be used for system shutdowns')
+    startstop.add_argument('-c', '--color', choices=['white','blue','lightblue','green','red','purple','yellow'], help='keyboard color out of fixed feature set', required=False)
+    startstop.add_argument('-b', '--brightness', type=int, help='keybpoard brightness between 0..255', required=False)
+    startstop.add_argument('--version', action='version', version='%(prog)s ' + ver, default='d')
+
+    args = parser.parse_args()
+
+    if args.verbose:
+        log.setLevel(logging.INFO)
+
+    elif args.debug:
+        log.setLevel(logging.DEBUG)
+    else:
+        log.setLevel(logging.ERROR)
+
+    logging.basicConfig(format='%(asctime)s %(message)s')
+
+    if args.start:
+        print("Keyboard: read and set Color and Brightness")
+        log.debug("System start")
+        kL = kbdLED_class("start", log)
+
+    elif args.stop:
+        print("Keyboard: read and save Color and Brightness")
+        log.debug("System stop")
+        kL = kbdLED_class("stop", log)
+
+    elif args.color:
+        print("Keyboard: set color " + args.color)
+        log.debug("resolveed Color=" + getattr(kbdLED_class.colors,args.color.upper()))
+
+        try:
+            log.debug("setup keyboard color " + args.color)
+            kL = kbdLED_class("color", log, INcolor=getattr(kbdLED_class.colors, args.color.upper()))
+        except AttributeError:
+            log.error("color does not exists " + args.color)
+            parser.print_help()
+            sys.exit((1))
+
+    elif args.brightness:
+        print("Keyboard: set brightness " + str(args.brightness))
+
+        log.debug("setup keyboard brightness " + str(args.brightness))
+        kL = kbdLED_class("brightness",log, INbrightness=args.brightness)
+
+    elif args.on:
+        print("Keyboard: enable Backlight LED")
+        kL = kbdLED_class("brightness",log, INbrightness=255)
+
+    elif args.off:
+        print("Keyboard: disable Backlight LED")
+        kL = kbdLED_class("brightness", log, INbrightness=0)
+
+    else:
+        parser.print_help()
+        sys.exit((10))
+
+sys.exit(0)