gnome-network-stats

Gnome extension for showing internet upload, download speed and per day data usage.

Network Stats

Roadmap

See details on Todo page.

Installation

install from https://extensions.gnome.org

The latest reviewed version can be found at

Download from github.com and install yourself

The latest development version can be installed manually with these commands:

git clone https://github.com/noroadsleft000/gnome-network-stats.git

cd gnome-network-stats

pnpm install

./scripts/configure.sh

make build

make install

Then go to https://extensions.gnome.org/local/ to turn on the extension or use gnome-tweak-tool to enable it.

Make commands

build extension

make build

install extension

make install

uninstall extension

make uninstall

enable extension

make enable

disable extension

make disable

pack the extension to zip file

make pack

launch a nested wayland session for debugging the extension

make debug

version workaround

If new gnome-shell version is not yet supported but you still want to use the extension

gsettings set org.gnome.shell disable-extension-version-validation true

Known issues

ERROR while updating extension from store.

Universal solution of all problems "Restart your machine" will work. Or you can restart the gnome-shell alone.

restart gnome-shell on X11:

"Alt + F2", "r + Enter"

restart gnome-shell on wayland or (ubuntu >= 21.10):

busctl --user call org.gnome.Shell /org/gnome/Shell org.gnome.Shell Eval s 'Meta.restart("Restarting…")'

kill gnome shell, works for both X11 and wayland:

killall -9 gnome-shell

still facing some error? report it by creating a bug.

Reporting a Bug

When reporting a bug, please include debugging output from gnome-shell.

You can capture the logs with one of these commands:

journalctl -f -o cat GNOME_SHELL_EXTENSION_UUID=network-stats@gnome.noroadsleft.xyz

journalctl /usr/bin/gnome-shell | grep network-stats

journalctl -f -o cat /usr/bin/gnome-shell

Developer resources

• Gnome Javascript guide
• Basic Gnome extension guide
• Gnome JS API documentation
• JS API documentaion - Unofficial
• Gnome JS API source code

Contibutors

Contributions are always welcome, fork this repository make your changes. and then generate a pull request.

License

GNOME Shell Extensions are distributed under the terms of the GNU General Public License. This extension is shipped under MIT License.