Not1MM Installation Guide on GNU/Debian 13 Trixie

[tomassenabre]

Given that Not1MM is a Python application that uses the Qt6 framework, here is the step-by-step procedure to properly install it on your Debian 13, using the standard Python community method:

Not1MM Installation on Debian 13 (Trixie)

This process ensures that you install the low-level Debian dependencies (apt) and the Python dependencies (pip) in a clean environment (venv).

---

Step 1: Install System Dependencies

First, you must ensure you have the necessary Hamlib, Python, and Qt6 libraries installed on your system.

1. Open a terminal and update the repositories:

   sudo apt update

2. Install the essential tools, the Hamlib development libraries (for CAT control), and the necessary Qt/Python libraries:

   sudo apt install git python3-venv python3-pip libhamlib-dev python3-pyqt6 build-essential

   Note: python3-pyqt6 will install the Python binding to the necessary Qt6 libraries.

---

Step 2: Download the Source Code

We will use git to obtain the latest version of the Not1MM code:

1. Go to your user folder or wherever you store your programs:

   cd ~

2. Clone the GitHub repository:

   git clone https://github.com/mbridak/not1mm.git

3. Enter the program folder:

   cd not1mm

---

Step 3: Create the Python Virtual Environment (Optional, but Recommended)

It is a good GNU/Linux practice to isolate Python dependencies from the main operating system.

1. Create the virtual environment (venv):

   python3 -m venv venv-not1mm

2. Activate the virtual environment. You must do this every time you run Not1MM:

   source venv-not1mm/bin/activate

   You will see that the terminal name changes, indicating that you are inside the environment.

---

Step 4: Install Python Dependencies

Now, use pip to install all the specific Python dependencies required by Not1MM (such as the Qt Python libraries, SQLite, etc.), listed in the requirements.txt file:

pip install -r requirements.txt

Once all dependencies are installed in the environment, you can execute the program directly:

python3 -m not1mm

---

Step 5: Install the WinKeyer Server

cd ~
git clone https://github.com/ok2cqr/winkeyer_server.git
cd winkeyer_server
make
sudo make install

For the server to remember the winkey settings, you can modify the server configuration in the configuration file (~/.config/winkeyer_server.cfg) that is created automatically after the first execution.
You should now be able to start Not1MM or any other program (TLF) that expects to find cwdaemon on port 6789.

---

Step 6: Create a Script to Launch Not1MM from Home

We will create an executable file called run_not1mm in your home directory.

vim ~/run_not1mm

Paste the following code:

#!/bin/bash

# --- WINKEYER_SERVER MANAGEMENT ---

# 1. Define a trap to ensure the server is killed upon exiting the script.
trap 'pkill winkeyer_server; echo "WinKeyer Server stopped."; deactivate' EXIT

# 2. Change to the Not1MM project directory and activate the environment
cd ~/not1mm || { echo "Error: Cannot access directory ~/not1mm"; exit 1; }
source venv-not1mm/bin/activate

# 3. Launch Winkeyserver in the background and in Daemon mode (-d)
# This uses the configuration saved in Step 5's configuration file.
echo "Starting WinKeyer Server on port 6789..."
/usr/bin/winkeyer_server -d &

# 4. Give the keyer a moment to start (2 seconds)
sleep 2

# 5. Execute the Not1MM application
echo "Launching Not1MM..."
python3 -m not1mm

You need to mark the file as executable:

chmod +x ~/run_not1mm

With these steps, you will have the latest version of Not1MM running on your Debian 13.