Skip to content

koldbyte/termoid

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Termoid

Terminal in a plasmoid.
Run your favourite shell or terminal applications like nethogs, htop, colortail etc. on your desktop as a widget/plasmoid.

View on KDE Store

Features

  • Terminal :)
  • Working keyboard and mouse input
  • Comes with many inbuilt color schemes
  • Configurable Font family and Font size in terminal
  • Configurable Opacity

Screenshots

Screenshot showing keyboard input Screenshot running Nethogs

Requirements

qmltermwidget package is required as this is the core of the plasmoid. Note: Latest qmltermwidget is causing Plasma to crash. Please use the 0.1.0 release or Commit 08958f7 which is known to work.

Source

Github Source

Build step: qmake && make

Arch Distros

qmltermwidget Package

Install version 0.1.0 using

sudo pacman -U https://archive.archlinux.org/packages/q/qmltermwidget/qmltermwidget-0.1.0-3-x86_64.pkg.tar.xz

Ubuntu

You would need to add a PPA to install "cool-retro-term". Steps: For Ubuntu 18.04, 18.10, 19.04, Linux Mint 19 and higher, use this PPA:

sudo add-apt-repository ppa:vantuz/cool-retro-term sudo apt update sudo apt install cool-retro-term

For Ubuntu 16.04 and Linux Mint 18 series, use this PPA:

sudo add-apt-repository ppa:noobslab/apps sudo apt update sudo apt-get install cool-retro-term

Fedora

qmltermwidget 0.1.0

Installation

Install via KDE

Right Click Panel > Panel Options > Add Widgets
Get New Widgets > Download New Widgets
Search: Termoid
Install
Right Click your desktop > Add Widgets
Select Termoid

KDE Store

Store link

Build it Yourself

git clone https://github.com/koldbyte/termoid.git termoid
cd termoid
sh ./install

Note:

  • ./install (for first time)
  • ./reinstall (for updating the plasmoid)

Add the Termoid widget from "Add widgets" on your desktop

  • The build/run commands require kreadconfig5.
  • Do not run the install/reinstall scripts with sudo or the plasmoid will be placed in /usr/share/ instead of your home directory.

Locations

  • /usr/share/plasma/plasmoids/
    Where KDE's default plasmoids are stored.
  • ~/.local/share/plasma/plasmoids/
    Where downloaded plasmoids are stored. It's also where this plasmoid will be installed to.

Using Nethogs in Termoid

Install package nethogs
Run sudo setcap "cap_net_admin,cap_net_raw+pe" /usr/bin/nethogs once on the system so that sudo permission is not required for running nethogs.

TODOs

  • Try packaging qmltermwidget within the plasmoid with a Cmake build. This should fix all the version issues.
  • Provide packages for major distros.
  • Support for button form in panel.
  • More configuration. (Suggestions are welcome)
  • Restart plasmoid command without restarting whole plasmashell. Use a shell. Keyboard input (along with Ctrl+C) works.
  • Support for Keyboard input. Done
  • Make sudo commands runnable. Sudo commands working now as the keyboard input is available.

Want to learn more about Plasmoids

ExampleRepositories

Note that official KDE software is only mirrored on github, however github is much better for navigating the codebase.

Documentation