cory/tildefriends
5
6
Fork 2
Code Issues 35 Pull Requests Actions Releases 35 Wiki Activity

[question] How do I use this? #124

New Issue
Closed
opened 2025-06-04 16:44:30 -04:00 by nichoth · 6 comments
nichoth commented 2025-06-04 16:44:30 -04:00
Copy Link

I see the "Getting started" section

image.png

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
Owner
Copy Link

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
Author
Copy Link

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
Owner
Copy Link

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
nichoth commented 2025-06-15 17:07:27 -04:00
Author
Copy Link

More questsions

Thanks @cory for the helpful responses. I am trying new clients because my old machine finally died.

I have the file, and I change the permission to +x

chmod +x ./tildefriends-macos-0.0.31

Then run the file

$ ./tildefriends-macos-0.0.31

setting zip path to ./tildefriends-macos-0.0.31
Zip ./tildefriends-macos-0.0.31: 0x11ee063c0
Starting broadcasts.
~😎 Tilde Friends 0.0.31 is now up at http://127.0.0.1:12345/.
will delete more blobs in 30000 ms
will delete more feeds in 25000 ms
Importing from ./tildefriends-macos-0.0.31.
Running script core/core.js
failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable
failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable
failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable
failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable
failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable

It does serve the localhost:12345 address; why the "failed to send broadcast" message?

__More questsions__ Thanks @cory for the helpful responses. I am trying new clients because my old machine finally died. ------- I have the file, and I change the permission to +x ```sh chmod +x ./tildefriends-macos-0.0.31 ``` Then run the file ``` $ ./tildefriends-macos-0.0.31 setting zip path to ./tildefriends-macos-0.0.31 Zip ./tildefriends-macos-0.0.31: 0x11ee063c0 Starting broadcasts. ~😎 Tilde Friends 0.0.31 is now up at http://127.0.0.1:12345/. will delete more blobs in 30000 ms will delete more feeds in 25000 ms Importing from ./tildefriends-macos-0.0.31. Running script core/core.js failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable ``` It *does* serve the `localhost:12345` address; why the "failed to send broadcast" message?
cory commented 2025-06-16 12:42:20 -04:00
Owner
Copy Link

failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable

Mostly harmless. It periodically tries to send discovery packets on all the network interfaces it can see. It's legitimate for some to not actually support that and give an error like this. Maybe you know your network setup well enough to know if 10.5.* is a normal network that should work?

I'll do something to make it only print once per interface. This has bugged me before.

> failed to send broadcast for 10.5.0.2 via 10.5.255.255 (-65): host is unreachable Mostly harmless. It periodically tries to send discovery packets on all the network interfaces it can see. It's legitimate for some to not actually support that and give an error like this. Maybe you know your network setup well enough to know if 10.5.* is a normal network that should work? I'll do something to make it only print once per interface. This has bugged me before.
❤️ 1
cory commented 2025-07-27 14:13:09 -04:00
Owner
Copy Link

I'm closing this, because I did what I can manage for now, but this is super important to me, so keep it coming / reopen / raise new issues as rough spots present themselves.

I'm closing this, because I did what I can manage for now, but this is super important to me, so keep it coming / reopen / raise new issues as rough spots present themselves.
cory closed this issue 2025-07-27 14:13:09 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone Good First Time Experience
Assignees
Clear assignees
cory
No Assignees
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: cory/tildefriends#124
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?