What IS Job Machine, anyway?

Job Machine started way back around 2012 as a Google Hangout chat amongst some co-workers. Eventually, it expanded and needed a better platform, and migrated to Slack.

Between then and now, it has grown significantly, morphed, shed old users, and gained new ones, eventually migrating to Matrix.

In Matrix, the Job Machine is a "Space", a collection of chat rooms of various topics. Each room may have its own administrator and moderators, as well as membership rules, but for the most part all rooms are available to join as long as you are a member of the Job Machine Space.

Anyone with a Matrix account is able to join our Waiting Room, where you can introduce yourself in order to be invited to the Space. If your Matrix account is on the jobmachine.org homeserver, you will be automatically added to the Waiting Room, but will still need to show signs of life and be invited to the Space to participate in our other rooms.

Once you have joined the Job Machine Space, you can "Explore Rooms" of the space and join anything that looks interesting! A few rooms are suggested as a place to get started, since it can be overwhelming at first.

Back to the top

Where is everyone?

Job Machine is a private community, but we aim to make accessibility easy. Currently the Job Machine Matrix server is open to federation, but all Job Machine-related rooms are only accessible to members of the Space (a collection of rooms), with a few of our rooms still requiring invitation even if you are a Space member. This means you can join with any Matrix account across the federated network and participate in Job Machine.

If you're joining us for the first time, welcome! Start by joining the #waitingroom:jobmachine.org and introducing yourself to the admins, and they'll be able to invite you to the Space.

Back to the top

Is there a code of conduct?

We have never needed any official Code of Conduct. Generally, because we're such a small group of people, everyone gets to know everyone else and problems tend to work themselves out. However it is worth saying that at a bare minimum the expectation is to treat everyone in Job Machine with respect.

BE EXCELLENT TO EACH OTHER

In the words of Bill and Ted: BE EXCELLENT TO EACH OTHER.

The only specific guidance is that calls for violence or hate speech will not be tolerated, as these viewpoints do not support a diverse community or foster intelligent discussion. This is the only warning.

Additionally, our community is founded on interaction. Getting to know each other requires actually talking to one another, and as such inactive members will occasionally be pruned from the community. If you are removed from the Job Machine and want to rejoin the conversation, ask to be re-invited by sending a message in the #waitingroom:jobmachine.org.

Repeat violators or "drive-by" members (folks who surface when they need help, but who generally do not provide any substantive help back) may notice less success when asking to be re-invited, as their behavior violates the "BE EXCELLENT TO EACH OTHER" ideology.

Back to the top

I forgot my password!

If you forgot your password, you can reset it by visiting the the web app login page, and simply follow the links to reset your password. This requires that you have associated an email address with your account at some point in time... if you never have, you will need to reach out to an administrator to reset your password.

Resetting your password will cycle your encryption keys... basically that means that you won't be able to read any old messages in encrypted rooms unless you have another session logged in somewhere. If you do, you can export your encryption keys, and import them into your new sessions. For help, please reach out to an administrator.

Back to the top

I lost/forgot my encryption key/passphrase!

Your encryption key or passphrase is used to securely back up encryption information. This allows you to read encrypted messages on multiple devices.

If you lost your key or forgot your passphrase, you can reset it from one of your logged-in sessions. Within your user settings, there is an option to "Reset" your Encryption Secure Backup key. The image below is from the user settings in the "Security and Privacy" section of user settings in the web app:

WebApp: Settings -> Security & Privacy

Back to the top

Is there an app for my phone?

YES! Not only is there an app, there are a few! A couple recommendations:


Element
Very full featured, with support for person-to-person voice and video calling. Because it is fully featured, that means it might be a little overwhelming for some folks.

FluffyChat
Simplified interface with a focus on being "cute". Does not support calling, but more similar to traditional text messaging apps.
Back to the top

How do I connect with a different client instead of the webapp?

There are many Matrix clients for many platforms, with a decent collection of info at https://matrix.org/clients/.

When connecting from another client, you will need to connect to whichever homeserver your account is associated with. If you have an account on jobmachine.org, that would look like this:

  • User ID: your-username
  • Matrix ID: @your-username:jobmachine.org
  • Homeserver Address: https://synapse.jobmachine.org

Some clients are able to figure this out just by entering your full Matrix ID, others can't. For the easiest use, we recommend you just use the web app which will automatically connect you to the correct homeserver.

If you're having trouble, reach out to an admin in the #waitingroom:jobmachine.org and someone will help sort you out.

If you're just looking for an alternative instead of Element, check out Cinny, which is perhaps less featureful in some aspects but a more pleasant user experience in others.

Back to the top

I can't find a room for my favorite topic.

Many topics have their own rooms, but not all. Feel free to bring your conversation to a vaguely related parent room or the breakroom. If it starts to take over and pick up steam from several people, ping an admin and we can use a special bot command to create a new room that aligns with the Job Machine standards and will be added automatically to the Space.

Back to the top

Is Job Machine encrypted?

Matrix (the technology that powers Job Machine) supports very strong end-to-end encryption if configured for the room in question. Direct messages are encrypted by default, and several of our rooms are encrypted. However, many of our rooms are still bridged to a private Slack team, and that bridging would not work properly if encryption were enabled in those rooms.

To see if a room is encrypted, just look for a shield icon next to the room avatar!

Back to the top

What can the bot do?

If you've been in any of our rooms, you've probably run into Cog, our resident bot (full matrix ID is @cog:jobmachine.org).

Cog can subscribe to RSS feeds, respond with an animated gif from Giphy.com, roll the dice, create polls, set reminders, and all kinds of other stuff. Just ask for help by saying !help in a room with Cog in it, and it will walk you through some other help commands.

Occasionally, Cog will have trouble recognizing you if you join an existing encrypted room. If you are unable to decrypt the messages that Cog is sending in that room, please let an administrator know in the #waitingroom:jobmachine.org and they'll give Cog a swift kick in the circuitboard.

Back to the top

Can I change the color of my displayed nickname?

No. The color of your nickname is determined by the client application using... [checks notes]... mysterious logic. You cannot change this unless you make changes to the code of the client application you are using.

Back to the top

Why does my nickname include my full matrix ID?

Because matrix allows you to set your nickname separately from your matrix ID, there is a possibility that more than one person can have the same nickname in the same room. This would be very confusing for other people in the conversation, so matrix clients automatically show the full matrix ID to differentiate them.

If you have a conflicting nickname with someone else in the room, you are free to change your nickname so that it doesn't conflict with theirs, and the matrix client will not need to differentiate your accounts.

Back to the top

How do some people have a different nickname or avatar in certain rooms?

You may find that someone has a different user picture or display name from themselves only within a certain room. This is a feature of some clients (currently the webapp and Element Desktop support it). In those clients, you can use the /myroomnick or /myroomavatar commands to set your profile data specifically within the context of that room.

For example, if your nickname is normally "Foo", you can go to the job board room and use the command:
/myroomnick Foo [looking]
to change your nickname just in that room to indicate that you are actively looking for a new job.

Or in the cars room, you may want to use /myroomavatar to set your avatar to a picture of your car. If you run the command just like that, it will open a file browser so you can upload a picture right from there. If the image you want to use has already been uploaded to Matrix unencrypted, you can also supply the MXC URI to the image, like this:
/myroomavatar mxc://jobmachine.org/SoMeRaNdOmGiBbErIsH
If you don't know how to find an image's MXC URI, just ask an admin and they'll help you out!

Back to the top

I'm getting an "Unable to decrypt" error, but only for messages from a specific person in an encrypted room. What's going on?

I cannot tell you how frustrating this bug has been for our community. Basically, sometimes your client (the app you use) loses track of all the members of an encrypted room, and so it forgets to send the keys to a few people. This key sending is how they're able to see your messages when you're using encryption, so it's kind of a big deal.

If you encounter this issue, either you or the person sending the un-decryptable messages can fix it going forward by either leaving the room and rejoining, or if you're on the web application/desktop app, using the /discardsession command. This will not magically make it possible to decrypt the old, undecryptable messages! This simply fixes the issue going forward. To test, be sure to send (or have the offender send) some new messages to make sure everyone can read them.

If you're a really cool person, before you do this step to fix it, you can use the /rageshake command (or on mobile, literally shake your phone). This will prompt you to send debug logs to the developers of Element, so they can see what is causing these issues. The more logs we send them about this, the more likely they'll be able to fix it! If you are prompted to associate your logs with a GitHub issue, use this one until we find a better open issue to associate them with.

Back to the top

What's the deal with the Challenge Coin? What's a Coin Check?

If you are lucky enough (or if you've signed up for a monthly recurring donation), then you probably have a challenge coin. Why? What does it mean? What do I do with it?

The challenge coin shows our logo on the obverse, the ten-toothed cog with a three-runged ladder in the center. The ten teeth were chosen to represent that Job Machine has been around in some form or another for over ten years now, and the ladder represents the general "ladder of success" that we are all climbing, whether that's financially, personally, or specific goals that we have.

On the reverse is an abstraction of a decentralized network, with multiple nodes connecting to each other. This diagram also makes the shape of "JM" which stands for Job Machine. Surrounding this motif is our slogan in Latin: Communitas, Scientia, Salaria (Community, Technology, Salary).

As for the purpose of the Challenge Coin itself, the following is shamelessly stolen from SignatureCoins.com:

Sharing a challenge coin with a group is a time-honored tradition rooted in the nation’s military representing teamwork, unity, and proof of exclusive membership. However, forgetting your own coin can be an expensive affair, potentially costing you a full round of drinks and an evening’s worth of mockery. Before letting that happen, you had best learn the five rules for keeping your challenge coin handy for a “coin check.”

  1. Initiating a “coin check” consists of a “challenge” and a “response.” If you are the “challenger,” then you initiate a “coin check” by slamming your challenge coin onto a table or bar. All other coin holders must then “respond” by drawing their coins out and slamming them down as well or otherwise present their own challenge coins for public view.

    1. Another acceptable form of challenge is holding your coin aloft and shouting “coin check” or another verbal form of communicating your intent to challenge.

    2. Depending on the circumstances, it is also acceptable to insistently tap your coin upon a surface or otherwise make it audibly known you are initiating a challenge.

    3. Points 1.1 and 1.2 may be preferable if you wish to remain in the good graces of the bar owner or any owners of the surrounding table surfaces.

  2. Failing to respond to a “coin check” when challenged carries a penalty. Any coin holder who fails to respond to a challenge with their own coin must buy a round of drinks to everyone who successfully responded.

    1. A penalty does not necessarily need to be a drink. It can take the form of any mutually agreed upon service or item of consumption. Please refer to your own group’s specific rules on the matter.

    2. The other coin holders are free to mock you mercilessly. You may feel appropriate shame and remorse for negligence at will.

    3. Participants are allowed a single “freebie” if they genuinely did not know the rules prior to a challenge. It is the responsibility of all other participants to fully explain the rules.

    4. Participants are allowed to take up to, but no more than, three steps away from their position at the time of the initial challenge to retrieve their coin.

  3. Should every coin holder present successfully respond, then the challenger is penalized. If you issue a challenge and all coin holders respond, then you must honor your challenge by purchasing a round of drink to all participants.

    1. Please refer to sections 2.1 and 2.2.

  4. A challenge may be issued at any time or place. So long as there are at least two coin holders in immediate proximity to each other, a challenge may be issued at any time or place.

    1. Issuing a challenge in the middle of a (solemn) funeral, emergency, or shower officially makes you a dick, and the rules of the “coin check” may or may not be honored. Locker rooms are fair game.

  5. Losing, misplacing, or gifting away your challenge coin does not grant immunity. Until your coin is replaced, you’re likely responsible for drinks whenever a “coin check” is issued.

    1. It is highly recommended you have your challenge coin replaced before word spreads you are coinless.

Back to the top