Gtk2::AppIndicator(3)

📦
version 0.15 · 2 versions
, in fedora 43

💖 Gtk2::AppIndicator(3) 💖

okay bestie, gather round, because this is the Gtk2::AppIndicator page from the User Contributed Perl Documentation, and it's literally your golden ticket into the Unity libappindicator situation. no cap. 🦋

✨ NAME ✨

Gtk2::AppIndicator — a Perl extension for libappindicator. that's the whole name, that's the whole vibe. 🎀

🌸 SYNOPSIS 🌸

here's the whole thing, character for character, because you're gonna want to run it exactly like this:

use Gtk2 '-init';
use Gtk2::AppIndicator;
use Cwd;

# Initialize the status icon. an_icon_name must be present
# at the icon theme path location, with an image extension like
# .jpg, .png or .svg, etc.
$status_icon=Gtk2::AppIndicator->new("AnAppName","an_icon_name");

# If you want to be in control over your icon location, you
# can set it manually. It must be an absolute path, in order
# to work.
my $absolute_current_working_directory=getcwd();
my $acwd=$absolute_current_working_directory;
$status_icon->set_icon_theme_path($acwd);

# Optionally set different icons
# $status_icon->set_icon_name_active("an_icon_name");
# $status_icon->set_icon_name_attention("an_other_icon_name");
# $status_icon->set_icon_name_passive("an_other_icon_name");

# Add a menu to the indicator
my $menu=Gtk2::Menu->new();
my $showcp=Gtk2::CheckMenuItem->new_with_mnemonic("_Show My App");
$showcp->set_active(1);
$showcp->signal_connect("toggled",sub { hide_show($window,$showcp); });
my $quit=Gtk2::MenuItem->new_with_mnemonic("_Quit");
$quit->signal_connect("activate",sub { Gtk->main_quit(); });

$menu->append($showcp);
$menu->append(Gtk2::SeparatorMenuItem->new());
$menu->append($quit);
$status_icon->set_menu($menu);

# Show our icon and set the state
$menu->show_all();
$status_icon->set_active();

pro tip from the comments themselves, bestie: an_icon_name must be present at the icon theme path location, with an image extension like .jpg, .png or .svg, etc. and if you're setting the icon location yourself, it must be an absolute path in order to work. no exceptions, she's strict. 💅

🌈 DESCRIPTION 🌈

this module hands you an interface to the new ubuntu Unity libappindicator stuff. that's the tea. ☕✨

👑 FUNCTIONS 👑

💜 the constructor

  • $ind=Gtk2::AppIndicator->new($application_id,$active_icon_name [,$category]) — creates a brand new application indicator object with the given name (id) and the icon name for the active icon. now about $category: it must be one of {'application-status','communications','system-services','hardware','other'} if you set it at all. if you don't set it, it defaults to 'application-status'. periodt. 🎀

🦋 icon theme path

  • $ind->set_icon_theme_path($path) — sets the icon theme path to 'path'. this is where icons should be found, with names like <active_icon_name>.png.
  • $ind->get_icon_theme_path() — hands back the (previously written) icon theme path, or undefined if it was never set. she's honest like that.

🍓 identity check

  • $ind->get_category() — returns the previously set category, the one you gave to the new function.
  • $ind->get_id() — returns the application id you gave to the new function.

✨ icon names, the main character energy

  • $ind->set_icon_name_active($name) — sets the icon name for the active icon.
  • $ind->get_icon_name_active() — returns the name of the icon for the active state.
  • $ind->set_icon_name_attention($name) — sets the icon name for the attention icon.
  • $ind->get_icon_name_attention() — returns the name of the icon for the attention state.

💅 states, because she contains multitudes

  • $ind->set_active() — makes the application indicator active. ⭐
  • $ind->set_attention() — makes the application indicator show the attention icon. 👀
  • $ind->set_passive() — makes the application indicator enter passive state, not showing any icon. she's resting, leave her alone. 😌
  • $ind->set_state($state) — sets the application indicator in the given state, one of {'active','passive','attention'}.
  • $ind->get_state() — returns the current state of the application indicator.
  • $ind->set_menu($menu) — sets the popup menu for the indicator icon.
  • $ind->get_menu() — returns the current menu. heads up: not from the C code, but as stored in the perl object. iykyk. 🙈

🫶 the middle-mouse-button situation

  • $ind->set_secondary_activate_target($widget) — sets the secondary active target (under the middle mouse button) to $widget.
  • $ind->get_secondary_activate_target() — returns the current secondary active target. again, not from the C code, but as stored in the perl object. keep that in your notes bestie. 📝

🌟 AUTHOR 🌟

Hans Oesterholt, <oesterhol@cpan.org> — shoutout to the icon who wrote this. 🫡

Copyright (C) 2012 by Hans Oesterholt <oesterhol@cpan.org>

This program is free software; you can redistribute it and/or modify it under the terms of the Artistic License, which comes with Perl.

okay so that's the whole page, and before you go — this one's from the perl v5.42.0 era, dated 2025-07-25, and it lives in Gtk2::AppIndicator(3) under the User Contributed Perl Documentation. slay, go build an indicator icon, you've absolutely got this. 💅✨🦋

📦 where this page comes from