Pino: Pixel Notification

Pino is a fully customizable notification tool that lets you display notifications with various options. It supports integration with Pywal to automatically match the notification theme to your wallpaper and includes customizable options for screen placement, fonts, and colors. You can also catch me in Discord: @pi66 .

Shortcuts

• Features
• Installation
• Usage
• Example: Low Battery Alert
• System Startup
• Configuration
• Dependencies
• Hardware Usage

Features

• Customizable Notifications: Set titles, messages, opacity, delay, sounds, and configuration files.
• Dynamic Theming with Pywal: Automatically matches the notification theme to your wallpaper.
• Configurable Settings: Adjust themes, screen placement, fonts, and more via JSON config files.
• Script Integration: Automate notifications using scripts in any language.
• Pluggable Architecture: Add custom scripts to the ~/.config/pino/plugs directory.
• System Start Scripts: Use pino_start to initialize scripts at system startup.

Installation

Run the install.py script to set up the application:

1

python install.py

Dependencies

Pino requires the following dependencies: - Python 3.6 or later - Libraries preinstalled in folder lib : - customtkinter A GUI Framework based on Tkinter - PyGame.Mixer PyGame Tweaked for sound - screeninfo lightweight lib to get size and place for the monitors - System tools: - python-tk GUI Toolkit - Optional: Pywal for dynamic theming

Usage

Pino supports a variety of command-line options:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

usage: pino [-h] [--title ] [--message ] [--opacity ] [--delay ] [--sound ] [--config ]

Options:
  -h, --help         Show this help message and exit
  --title            Set the notification title content
  --message          Set the notification message content
  --opacity          Set the opacity level for the window (range: 0 to 100)
  --delay            Set the delay before the program closes (in seconds)
  --sound            Set a custom sound file for notifications
  --config            Set a custom configuration file

Example: Low Battery Alert

You can create a script to notify about low battery status. Example in C:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>

void pino(const char *title, const char *message) {
  char command[256];
  snprintf(command, sizeof(command), "pino --title \"%s\" --message \"%s\"", title, message);
  system(command);
}

int main() {
  pino("Low Battery", "Please plug your charger in!");
  return 0;
}

Compile and save the script to ~/.config/pino/plugs/.

System Startup

Add pino_start to your system startup to enable all scripts automatically.

Configuration

The app uses a JSON configuration file located at ~/.config/pino/config.json. Example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

{
  "screen": {
    "monitor": 0,
    "vertical": "right",
    "horizontal": "top",
    "x": 20,
    "y": 20,
    "width": 300,
    "height": 100,
    "opacity": 100,
    "show": 3
  },
  "frame": {
    "fg_color": "#1a1e24",
    "font_family": "Fira Code",
    "border": {
      "width": 3,
      "color": "#566D8d",
      "border_radius": 10
    }
  },
  "title": {
    "color": "#c5c6c8",
    "font_size": 19,
    "x": 10,
    "y": 10,
    "weigth": "bold",
    "wrap_length": "auto"
  },
  "message": {
    "color": "#626977",
    "font_size": 15,
    "x": 15,
    "y": 45,
    "weigth": "normal",
    "wrap_length": "auto"
  },
  "optional": {
    "pywal": true,
    "sound": true
  }
}

Hardware Usage

Pino is lightweight and efficient. The graphical notification window typically uses approximately 30MB of RAM when active, ensuring minimal system resource consumption.