How to set up icon in kickoff (plasma 6)

kazimierzkrauze · November 5, 2025, 6:44am

Hi! Hope that some plasma-manager developers are here.

How can I set the icon for kickoff in plasma? To be more specific I want to change the first icon on the left:

and I want to use a .jpeg file. Is it possible to accomplish that?
I know about this option:

programs.plasma.panels = [
  {
    widgets = [ { kickoff.icon = com.some-system-icon; } ]
  }
];

But I can use only those which are installed with other applications.

Best,
Miro

harrytheblack · December 12, 2025, 1:16pm

Hi there!

I’m not a plasma-manager developer, however I do use it quite a bit

What you’re asking for is actually described explicitly when you check the description:

github.com/nix-community/plasma-manager

modules/widgets/kickoff.nix

b24ed4b27


      
            description = "The size of the widget. (Only for desktop widget)";
          };
          icon = lib.mkOption {
            type = with lib.types; nullOr str;
            default = null;
            example = "start-here-kde-symbolic";
            description = ''
              The icon to use for the kickoff button.
          
              This can also be used to specify a custom image for the kickoff button.
              To do this, set the value to a absolute path to the image file.
            '';
          };
          label = lib.mkOption {
            type = with lib.types; nullOr str;
            default = null;
            example = "Menu";
            description = "The label to use for the kickoff button.";
          };
          sortAlphabetically = mkBoolOption "Whether to sort menu contents alphabetically or use manual/system sort order.";
          compactDisplayStyle = mkBoolOption "Whether to use a compact display style for list items.";

So what you do is, set the icon value to an absolute path that matches your desired icon.

  programs.plasma.panels = [{
    widgets = [{
      name = "org.kde.plasma.kickoff";
      config = { General = { icon = "/home/myuser/myownicon.png"; }; };
    }];
  }];

So long as you store the icon in an accessible place, it should load your icon next time you log in.

kazimierzkrauze · December 13, 2025, 6:42am

Thanks a lot!
I have overlooked that…
Miro