https://github.com/mahcodes/nostrfetch
Share your Nostr profile in your screenshots on r/unixporn
https://github.com/mahcodes/nostrfetch
fetchapp neofetch nostr nostr-protocol unixporn
Last synced: 3 months ago
JSON representation
Share your Nostr profile in your screenshots on r/unixporn
- Host: GitHub
- URL: https://github.com/mahcodes/nostrfetch
- Owner: MAHcodes
- License: gpl-3.0
- Created: 2023-04-03T17:39:44.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-04-13T02:12:18.000Z (about 3 years ago)
- Last Synced: 2025-08-01T12:04:13.405Z (11 months ago)
- Topics: fetchapp, neofetch, nostr, nostr-protocol, unixporn
- Language: Go
- Homepage: https://github.com/MAHcodes/nostrfetch/
- Size: 47.9 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌐 nostrfetch
Share your [Nostr](https://github.com/nostr-protocol/nostr) profile in your screenshots on [r/unixporn](https://www.reddit.com/r/unixporn/)


## 📝 Notes
- Profile preview is only supported on [Kitty](https://github.com/kovidgoyal/kitty) terminal emulator.
- The image preview is displayed on top of the text rather than to the side; this is a feature, not a bug.
## 🚀 Installation
You can download pre-built binaries for various operating systems from the [releases](https://github.com/MAHcodes/nostrfetch/releases) page.
Alternatively, you can build the application from source by following the instructions in the next section.
## 🔨 Build from Source
To build nostrfetch from source, follow these steps:
1. Clone the repository: `git clone https://github.com/MAHcodes/nostrfetch.git`
2. Navigate to the project directory: `cd nostrfetch`
3. Install dependencies: `go get ./...`
4. Build the application: `go build -o nostrfetch main.go`
This will build the `nostrfetch` binary in the current directory.
You can also use `go install` to install the binary to your `$GOPATH/bin` directory:
```
go install .
```
This will install the `nostrfetch` binary to `$GOPATH/bin`.
Note that building from source requires Go to be installed on your machine. You can download the latest version of Go from the [official website](https://golang.org/dl/).
## 📖 Usage
1. Create a configuration file at `$XDG_CONFIG_HOME/nostrfetch/config.yaml`. If `$XDG_CONFIG_HOME` is not set, you can use `~/.config` instead.
Here's an example configuration file:
```yaml
# The URL of the Nostr relay to use
relayURL: wss://relay.damus.io
# The npub public key for the profile you want to fetch
npub: npub1qd3hhtge6vhwapp85q8eg03gea7ftuf9um4r8x4lh4xfy2trgvksf6dkva
```
2. Run `nostrfetch`
## 👥 Contributing
Pull requests are welcome! Please follow these guidelines:
1. Fork the repo
2. Create a new branch for your feature (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new pull request
## 📝 License
This project is licensed under the terms of the [GNU General Public License v3.0](LICENSE).
## 🧑 Authors
- [@MAHcodes](https://github.com/MAHcodes/nostrfetch)
## 🙏 Acknowledgments
- [fiatjaf](https://github.com/fiatjaf)
- [xdg-go](https://github.com/casimir/xdg-go)
- [dolmen-go/kittyimg](https://github.com/dolmen-go/kittyimg)
- [i582/cfmt](https://github.com/i582/cfmt)