https://github.com/brendaw/add-username-toppanel
Simple GNOME Extension to add your username to topbar panel aggregate menu.
https://github.com/brendaw/add-username-toppanel
gnome gnome-shell gnome-shell-extension linux panel topbar username
Last synced: 6 days ago
JSON representation
Simple GNOME Extension to add your username to topbar panel aggregate menu.
- Host: GitHub
- URL: https://github.com/brendaw/add-username-toppanel
- Owner: brendaw
- License: mit
- Created: 2016-09-04T09:18:28.000Z (almost 10 years ago)
- Default Branch: main
- Last Pushed: 2026-06-08T21:03:00.000Z (25 days ago)
- Last Synced: 2026-06-08T22:09:23.734Z (25 days ago)
- Topics: gnome, gnome-shell, gnome-shell-extension, linux, panel, topbar, username
- Language: JavaScript
- Homepage: https://extensions.gnome.org/extension/1108/add-username-to-top-panel/
- Size: 58.6 KB
- Stars: 20
- Watchers: 1
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS.md
Awesome Lists containing this project
README
# Add Username to Top Panel
Simply add your display name to the top panel Quick Settings menu in GNOME Shell.
## Features
- Displays your system display name in the Quick Settings menu of the top panel
- Positioned at the right end of the Quick Settings indicators
- Compatible with GNOME Shell 45 to 50
- Lightweight with no external dependencies
## Installation
### Via GNOME Extensions
Requires [GNOME Shell Integration](https://wiki.gnome.org/Projects/GnomeShellIntegrationForChrome) in your browser.
> ⚠️ The version on GNOME Extensions may lag behind the latest release while the submission is under review. For the newest version, install manually using the steps below.
### From a release ZIP
1. Download the latest `.zip` from the [Releases page](https://github.com/brendaw/add-username-toppanel/releases/latest)
2. Install the extension:
```bash
gnome-extensions install add-username-toppanel@brendaw.com.zip
```
3. Log out and back in, then enable the extension:
```bash
gnome-extensions enable add-username-toppanel@brendaw.com
```
### From source
1. Clone the repository:
```bash
git clone https://github.com/brendaw/add-username-toppanel.git
```
2. Copy the extension files to the extensions folder:
```bash
cp -r add-username-toppanel/src ~/.local/share/gnome-shell/extensions/add-username-toppanel@brendaw.com
```
3. Log out and back in, then enable the extension:
```bash
gnome-extensions enable add-username-toppanel@brendaw.com
```
## Compatibility
This extension supports GNOME Shell 45 to 50.
> For GNOME Shell 3.12 to 44, use a [legacy release](https://github.com/brendaw/add-username-toppanel/releases) (v2.x or earlier).
## Troubleshooting
### Extension shows "Unknown" instead of my name
This extension displays the **display name** from your system (the GECOS field in `/etc/passwd`),
not the login username. If it shows "Unknown", the display name field may be empty in your system.
Check your entry in `/etc/passwd` and fill in the display name field as shown below —
it will appear after the next GNOME Shell boot.
For other problems, check the [open issues](https://github.com/brendaw/add-username-toppanel/issues) or open a new one.
## Contributing
Contributions are welcome — new features, bug fixes, documentation improvements, and translations.
See [CONTRIBUTING.md](CONTRIBUTING.md) for the development workflow.
The project uses GitHub Actions for automated linting, extension package validation with [shexli](https://pypi.org/project/shexli/), and GitHub Releases on every version tag.
[Issues](https://github.com/brendaw/add-username-toppanel/issues) and
[Pull Requests](https://github.com/brendaw/add-username-toppanel/pulls) are open for your contribution.
## Support
If this extension is useful to you, consider supporting it:
## Contributors
See the [AUTHORS](AUTHORS.md) file for the amazing contributors of this project.
## License
[MIT](LICENSE) - William Brendaw and the contributors - 2016-2026