Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nao1215/honeycomb

[WIP] 🐝 honeycomb - Nostr client CLI application for cross-platform
https://github.com/nao1215/honeycomb

cross-platform golang nostr nostr-client

Last synced: about 2 months ago
JSON representation

[WIP] 🐝 honeycomb - Nostr client CLI application for cross-platform

Awesome Lists containing this project

README 

        
## Nostr client CLI application for cross-platform



[![All Contributors](https://img.shields.io/badge/all_contributors-1-orange.svg?style=flat-square)](#contributors-)



[![Build](https://github.com/nao1215/honeycomb/actions/workflows/build.yml/badge.svg)](https://github.com/nao1215/honeycomb/actions/workflows/build.yml)

[![MultiPlatformUnitTest](https://github.com/nao1215/honeycomb/actions/workflows/unit_test.yml/badge.svg)](https://github.com/nao1215/honeycomb/actions/workflows/unit_test.yml)

[![reviewdog](https://github.com/nao1215/honeycomb/actions/workflows/reviewdog.yml/badge.svg)](https://github.com/nao1215/honeycomb/actions/workflows/reviewdog.yml)



> [!CAUTION]

> Work in progress. Development just started on May 17, 2024. Some features are not yet implemented.



![sample](doc/img/new_sample.gif)



Honeycomb is an application that uses the Nostr Protocol to post messages and view trends from the terminal. It is designed to offer both a Command Line Interface and a Text User Interface.



My main purposes for developing Honeycomb are the following:



- To create a comfortable social network as an alternative to X (formerly Twitter) and BlueSky.

- To serve as a testing ground for trying out new technologies.



I enjoy having a free environment and working in the terminal. Therefore, I intend to develop a user-friendly CLI.



## How to install

**go install**

```shell

go install github.com/nao1215/honeycomb@latest

```



**homebrew**

```shell

brew install nao1215/tap/honeycomb

```



## Supported platforms and requirements

- Linux

- macOS

- Windows

- go 1.21 or later



## How to use



### Log in with an existing account

Honeycomb checks for the presence of a private key (e.g. nsec**) available at `${XDG_CONFIG_HOME}/.config/honeycomb/private_key`. If no private key is found, honeycomb will prompt you to enter your private key.   



Honeycomb validates the private key and stores the correct private key locally. 

The feature to create a new account using Honeycomb is not yet implemented. However, we plan to offer this functionality in the future.



![login](./doc/img/nseckey-input.png)



### View timeline, follow users, and more

Once you have logged in, you can view your timeline, follow users, and more. Now, we have several tabs that are not yet implemented.



Press 'R' to retrieve the latest timeline. Continuously scrolling down on the timeline screen will automatically fetch older posts.



![timeline](./doc/img/timeline.png)  

  

![follow](./doc/img/follow.png)



### Reaction to messages

Honeycomb allows you to react to posts. The reactions will include Reply, Repost, Like, Unlike, and Zap (not yet implemented). The reaction modal can be displayed by pressing the Enter key to select the topmost post.



![reaction](./doc/img/reaction.png)



### Post a message

You can post a message by pressing the `p` key. The message will be displayed in the timeline of the users who follow you.



![post](./doc/img/post.png)



### Key bindings

- `Ctrl + C`, `q`, ``: Exit

- `TAB` : Switch tabs

- `SHIFT + TAB` : Switch tabs in reverse order

- ↑, ↓ : Move cursor

- `p` : Show post form



## Contributing

First off, thanks for taking the time to contribute! See [CONTRIBUTING.md](./CONTRIBUTING.md) for more information.  Contributions are not only related to development. For example, GitHub Star and [GitHub Sponsor](https://github.com/sponsors/nao1215) motivates me to develop!



**Star History**



[![Star History Chart](https://api.star-history.com/svg?repos=nao1215/honeycomb&type=Date)](https://star-history.com/#nao1215/honeycomb&Date)



## Contact

If you would like to send comments such as "find a bug" or "request for additional features" to the developer, please use one of the following contacts.



- [GitHub Issue](https://github.com/nao1215/honeycomb/issues)

- [Nostr](https://nostter.app/npub1xe406xww9s4vla878wd4h6605wqaka9wdammxvpd5he9nysf2z7q0f7804)



## License

This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.



## Contributors ✨



Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):



  

    

      CHIKAMATSU Naohiro
CHIKAMATSU Naohiro
💻 📖

    

  

  

    

      

        

          Add your contributions

        

      

    

  



This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!