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

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

What is SSO / JMID? I'm having password / login problems.

SSO stands for "Single Sign-On". Moving forward, accounts in Job Machine will be tied to an external Identity Provider (Job Machine ID, or JMID, powered by software called Authentik) so that, as the services we offer expand, you won't need multiple accounts to access them!

To manage your account details, like password or email address, visit auth.jobmachine.org . From there, you'll be presented with links to whatever services you have access to, and at any of those services you'll generally be given the opportunity to "Log in with JMID".

There are some edge cases where you may still need to set up username/password credentials in Matrix (specifically, if you are trying to log into Element X applications). In this case, you should be able to go directly to the web app, and simply follow setting instructions to reset your password.

If you have an older account from before Single Sign-On was implemented, please reach out to an administrator so they can configure your account, and avoid any unexpected complications!

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

If you have an account on the jobmachine.org homeserver, most clients should give you a button that just says "Log in with JMID", and you'll be taken through a login process as described in the SSO topic.

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.

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

Back to the top

I joined a room and it looks like there are no messages?

Some rooms are encrypted, and the keys associated with the old messages were probably not shared with you because you just joined. This is totally normal, don't assume that a room is "dead" just because you can't see the conversation history!

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, roll the dice, 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.

Back to the top

Can I change the color of my displayed nickname?

Generally, no. This is set by whatever app you're 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, since this bit of info is always unique.

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