README.md

What is Omura?

Omura is a small-CLI small-client to access the Gemini Protocol sites. A Gemtext-based Web Alternatives Protocol.

Omura: 大村 / Large Village. It is a placename and surname found throughout Japan and the Ryūkyū Islands. The name listed in the Shinsen shōjiroku may be taken from a district in Hizen (now Nagasaki prefecture).

Why Omura?

Omura is simple (Only commands, yes, commands.) and extensible (powered by UNIST AST and TypeScript) project to access the Gemini Protocol sites, it's easy to use, you can run below than 5 minutes, thanks to JavaScript runtime engines.

How to run Omura?

Bunx recommended: v1.1.3

# Install omura with bunx
bunx add omura
# then run
bunx omura

# Fix `UNABLE_TO_VERIFY_LEAF_SIGNATURE: unable to verify the first certificate`
NODE_TLS_REJECT_UNAUTHORIZED=0 bunx omura

# Local development (Same directory)
NODE_TLS_REJECT_UNAUTHORIZED=0 bunx .

npx recommended: v10.5.0

npx omura

Acknowledgments

Omura takes heavy inspiration from the following:

• @derhuerst/gemini (Jannis R) - Implementation of Gemini Client and Server in Node.js

• gemini://geminiprotocol.net/docs/protocol-specification.gmi (Solderpunk - the man behind Gemini Protocol) - Gemini Protocol Specification

• @MasterQ2/kristall (MasterQ2) - Graphical Small-Internet Client for windows, linux, MacOS X and BSDs.

License

Omura is MIT-licensed open-source software by @fzn0x.