Troubleshooting

Background transparency

To achieve background transparency, after installing panon, go to ~/.local/share/plasma/plasmoids/panon/contents/ui/main.qml in your home directory, alter the following part and add the line marked below:

   Plasmoid.preferredRepresentation: Plasmoid.compactRepresentation
++ Plasmoid.backgroundHints: PlasmaCore.Types.NoBackground

Cannot load the Visual Effects page in the configuration dialog

If your KDE Framework older than 5.63, your system will not provide the qml component NewStuff.Button required by the Visual Effects page. There are 2 solutions.

1. Downgrade panon to version 0.3.1, which does not require this component.
2. Remove the component manually from ConfigEffect.qml.

import org.kde.newstuff 1.1 as NewStuff

NewStuff.Button {
    downloadNewWhat: i18n("Effects")
    configFile: Utils.get_root() + "/config/panon.knsrc"
    onChangedEntriesChanged:{
        /*
         * Triggers the executable DataSource to execute this line again: 
         * if(shaderOptions.count<1)return[sh_get_visual_effects]
         * So that the list model shaderOptions will be refreshed.
         */
        shaderOptions.clear()
    }
}

Module “QtWebSockets” is not installed

This error has been mentioned in tj-wolf’s comments in https://store.kde.org/p/1326546/ and in https://github.com/rbn42/panon/issues/27.

I guess plasma will be able to find the module after restarted. If you encounter this error after installed qt5-websockets, you can try

1. Restart plasma-shell or latte-dock.
2. Logout the Plasma session.