[question] How do I use this? #124

New Issue

nichoth · 2025-06-04T16:44:30-04:00

nichoth commented

2025-06-04 16:44:30 -04:00

I see the "Getting started" section

I download tildefriends for mac, and now I have a file with no extension. What do I do with this?

I see the "Getting started" section ![image.png](/attachments/bea553b2-4467-4a11-80bf-55439ff40997) I download tildefriends for mac, and now I have a file with no extension. What do I do with this?

image.png

83 KiB

cory commented

2025-06-04 17:48:57 -04:00

Ah, yep. It's a command-line executable.

I would do something like this:

Open Terminal.app
cd ~/Downloads
chmod +x tildefriends-macos-0.0.31
./tildefriends-macos-0.0.31

Subsequently, you might be able to double-click on it to skip a few steps? Not sure. I'm not a regular mac user.

There is #81 as a reminder to myself to make this better.

Ah, yep. It's a command-line executable. I would do something like this: * Open Terminal.app * `cd ~/Downloads` * `chmod +x tildefriends-macos-0.0.31` * `./tildefriends-macos-0.0.31` Subsequently, you might be able to double-click on it to skip a few steps? Not sure. I'm not a regular mac user. There is #81 as a reminder to myself to make this better.

nichoth commented

2025-06-05 00:34:01 -04:00

Thanks for the reply.

It is not clear to me what it is that I'm installing. I have looked at the docs and the main webpage, and all I gather is that this is an ssb app.

Is this a GUI app or CLI?
if GUI, how? How does it work?
- browser?
- native app?

Thanks for the reply. It is not clear to me what it is that I'm installing. I have looked at the docs and [the main webpage](https://www.tildefriends.net/~cory/welcome/), and all I gather is that this is an ssb app. * Is this a GUI app or CLI? * if GUI, how? How does it work? - browser? - native app?

cory commented

2025-06-05 08:54:57 -04:00

The desktop (windows, linux, macos, ...) builds run a web server at http://localhost:12345/ by default that you'll want to visit with your browser.

It can also do a bunch things from the CLI, but anyone who needs that can discover them by running with -h for help.

The mobile apps (android, ios) basically do the same but take you there in a webview automatically so that it looks somewhat native.

I should also say, "installing" is a strong word. Everything is contained in the one executable. All user data is stored in one db.sqlite file.

One source of complication is that I eventually want this to be much more than another SSB client, but that's where I'm focused right now.

I do very much appreciate this thread. I will do something with this to improve the overall documentation later.

The desktop (windows, linux, macos, ...) builds run a web server at http://localhost:12345/ by default that you'll want to visit with your browser. It can also do a bunch things from the CLI, but anyone who needs that can discover them by running with `-h` for help. The mobile apps (android, ios) basically do the same but take you there in a webview automatically so that it looks somewhat native. I should also say, "installing" is a strong word. Everything is contained in the one executable. All user data is stored in one `db.sqlite` file. One source of complication is that I eventually want this to be much more than another SSB client, but that's where I'm focused right now. I do very much appreciate this thread. I will do something with this to improve the overall documentation later.

❤️ 1

cory added this to the Good First Time Experience milestone 2025-06-09 21:11:05 -04:00

cory referenced this issue from a commit

2025-06-11 18:39:21 -04:00

welcome: Update the welcome page to be a bit more direct and relevant. #124

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: cory/tildefriends#124