đŸ Archived View for geminiquickst.art captured on 2024-08-18 at 16:28:15. Gemini links have been rewritten to link to archived content
âŹ ïž Previous capture (2023-09-28)
-=-=-=-=-=-=-
Skip to main content
About Contact
Gemini is a new way of using the Internet, separate from the World Wide Web you are familiar with. Compared to the WWW, it is intended to be:
More details are in the Official Gemini FAQ. Be aware that itâs targeted at a more technical audience than this quick start page, so you might want to skip it for now and come back later. The main thing to know is that youâre going to get a much more stripped-down experience compared to the modern WWW, but thatâs okay! Some of the choices made to keep Gemini simple may seem too extreme, compared to even a bare-bones web site, but there are hidden benefits that wonât be obvious at first.
FAQ
The first thing to do is to install a Gemini client. A Gemini client is like a web browser, except instead of browsing the web, it browses Geminispace. There are at least a couple of Gemini clients available for most platforms. Here, Iâm going to recommend just one, that I think will feel most familiar or least surprising to new users. That doesnât mean I think the other ones are bad. A lot of it is just personal preference, just like with web browsers. After you get used to Gemini with the client I recommend, you may want to try some others.
You may be used to doing everything in the web browser, and find it strange or uncomfortable to have to install a different program to read Gemini pages. But youâll get used to it; the WWW tries to be everything to everyone, both a floor-wax and a toothpaste, while Gemini tries to be good at just one thing.
You have several options for a Gemini browser on Windows, but Iâm going to recommend that you install Geminaut, because of its comfortable, Windows-native user interface. Download and run the latest MSI file from the website. You will get a warning that the installer isnât signed, which is because the developer is an independent hobbyist. If you downloaded it directly from the link above, it should be safe to ârun anywayâ.
[⥠A screenshot of GemiNaut on Windows 10] >>
Lagrange is another good option â it has more features and is lightweight, but the user interface isnât native like GemiNautâs. There is also a nightly build of Kristall.
There are several Gemini clients that can be built for MacOS, but the only one I know of that provides pre-built downloads for a released version is Lagrange. Thatâs okay, because Lagrange is a very good browser. The UI doesnât use native controls, but itâs light and fast.
[⥠A screenshot of Lagrange on MacOS] >> [⥠Another screenshot of Lagrange on MacOS] >>
There may also be nightly builds of Kristall, if youâre so inclined.
There is one Gemini client on the app store, called Elaho. There is another one on TestFlight called Rocketeer.
[⥠A screenshot of Elaho on iPhone] >>
For Android, I recommend Ariane. The developerâs site has several different download options, but if you are at all unsure, you should install from Google Play.
Deedum is also a good client for Android, but its UI is not quite as simple.
[⥠A screenshot of Ariane on Android 10] >> [⥠A screenshot of deedum on Android 10] >>
Play
If youâre able to compile programs from source, you are spoiled for choice. Most Gemini clients are developed for Linux. The main GUI choices are:
If you need a binary release, you will probably need to install Lagrange. Lagrange is on FlatHub, so if your distribution supports FlatPaks, youâre in luck. There is also a nightly AppImage of Kristall, if you prefer.
[⥠A screenshot of Lagrange on Linux (sway)] >> [⥠A screenshot of kristall] >> [⥠A screenshot of castor, with quite an odd GTK theme] >>
FlatHub
The situation here is similar to Linux GUI clients, but there are at least two that have binary releases:
If youâre not sure which you want, go for Amfora; it has more familiar keybindings than Bombadillo.
If thereâs no Gemini client for your platform, but there is a web browser, you can use a proxy. Either portal.mozz.us or proxy.vulpes.one should work for your needs.
You shouldnât use a proxy just because you donât want to install a Gemini client, though! You will miss out on the experience of not using the web browser.
By now, you should have a Gemini client installed. If youâve tried to install one, but gotten stuck, please feel free to give me an email at help@geminiquickst.art. I donât mind! You can do this next part using one of the web portals, but it would be better if you had a real client installed.
First, open up your Gemini client, and arrange it so that you can see both the Gemini client and the web browser youâre reading this in. You should be able to follow the rest of this tutorial in Gemini. In your Gemini client, open gemini://geminiquickst.art/. You may or may not be able to click on that link from your web browser and have it open up in your Gemini client, depending on a lot of nerd stuff that you donât have to care about now. If it doesnât open up on click, copy and paste gemini://geminiquickst.art/ into your Gemini client. You should get a page thatâs pretty much the same as this one, though the colors and fonts may be different. Scroll it down until you reach this point, then read the rest of your page in your Gemini client, rather than your web browser.
Gemini is pretty new, so like the early web, thereâs not as much content as youâre used to on the modern web, and too much of it is tech stuff. But thereâs a lot of other stuff there too, if youâre willing to look.
One of the main things people have been using Gemini for is blogging. And it makes sense, because blogs are mostly text, itâs easy to find updates, and the web has made a real mess of it, where it hasnât completely abandoned it to social media.
Several of the clients recommended above have built in feed-readers for subscribing to gemlogs and staying informed about updates. If yours does, I recommend that you take advantage of that feature as you find gemlogs you want to read. It will be more flexible than depending on a feed aggregator hosted by someone else, and easier than setting up your own feed aggregator.
But to find feeds to subscribe to, youâre best off starting with an aggregator someone else is running. This is a list of well-known public aggregators in Geminispace.
specification
Because Geminispace is a lot smaller than the web, itâs still somewhat possible to hand-curate a list of interesting sites. You may remember how Yahoo! got its start as a curated index of links by topic.
You can also search Gemini, just like you can search the web. However, itâs not indexed by Google or Bing or DuckDuckGo; we have our own search engines. Or rather, search engine. There have been three search engines built for Gemini, but only one is currently active: Geminispace.info.
That said, search is not as important, currently, on Gemini as it is on the WWW. Subscriptions and cross-site links are the main ways of finding new things.
This part is a little harder, but people are busily working on making it easier! The first thing that you should know is that thereâs no direct equivalent of the WWWâs social media sites on Gemini. Gemini doesnât have a built-in method for posting things, so most people posting on Gemini right now are using separate tools to write their pages or posts and to upload them to a server. And thatâs leaving out registering an account on the server, which is usually done manually by the site owner! But that situation is going to get better. Right now, there are a few Gemini sites where the âseparate toolsâ for registering an account and posting pages or updates are web applications, and itâs likely that someone will make an integrated native application.
Shared hosting on Gemini today is pretty similar to shared hosting on the WWW in 1999, but in general more community-oriented and friendlier. If you think of these sites as being like GeoCities, but without neon backgrounds and blinking âunder constructionâ GIFs, you wonât be too far wrong.
With these sites, you will sign up, either via the web or email, and have a space that you can access with a native graphical file transfer application such as FileZilla (Windows, MacOS, or Linux). Youâll write Gemtext documents on your own computer, then copy them to your host with Filezilla or a similar program. Some of these sites will want you to send an SSH public key, which may sound too technical, but Digital Ocean has a pretty good guide to using them with FileZilla. Itâs focused on their own VPS service, but most of it should apply here, too.
Ocean
One warning â if youâre on Windows and youâre not careful with how you install Filezilla, you may end up with some additional bundled software you donât want. For Windows users, I recommend Winscp as an alternative.
café
City
A pubnix is a PUBlic uNIX server, a kind of shared computer for use by members of a community. Theyâre usually used by logging in to a terminal interface using an SSH (secure shell) client. Thatâs actually a very good way to dip your toes into the more technical side of Gemini (and Gopher, and WWW) hosting, but itâs understandable if itâs not for you. Many pubnixes offer Gemini hosting to their members.
These are a few pubnixes with Gemini hosting:
The Mare Crisium Soviet Socialist
Regency
The Mare Tranquillitatis Peopleâs Circumlunar
Zaibatsu
The Mare Serenitatis Circumlunar Corporate Republic
Itâs not hard, as these things go to set up a Gemini server on a VPS (Virtual Private Server), a collocated server, or a Raspberry Pi in a shoebox under the bookshelf your router sits on. However âas these things goâ covers a lot of evils. Youâll generally need to be familiar with the Unix or Linux command-line, installing software from a distribution repository, and with compiling software from source.
I do not yet have any How-To documents collected for self-hosting a Gemini server. Please let me know if you find or write one!
Thatâs it! Hopefully by this point you have found some things you want to read on Gemini, ideally things youâve subscribed to that will keep you coming back. And if things have gone really well, youâll have established a foothold of your on in Geminispace, and Iâll be reading something youâve shared in not too long.
If any of the steps in this document were unclear or you need help for another reason, please feel free to email help@geminiquickst.art.
If you see something thatâs missing (like a hosting site you want to recommend), or something wrong, please mail info@geminiquickst.art.
Thank you for reading! See you out there!
© Jason McBrayer, 2023
[⥠This work is licensed under a Creative Commons Attribution NonCommercial ShareAlike 4.0 License]
Powered by Hugo, theme Anubis.
Dark theme
http://creativecommons.org/licenses/by-nc-sa/4.0/
Jason McBrayer / jmcbray@carcosa.net
