diff --git a/src/content.ts b/src/content.ts index 1a05515..5bed476 100644 --- a/src/content.ts +++ b/src/content.ts @@ -24,13 +24,10 @@ export const englishPages = allPages.filter(isEnglishEntry) export const pageOrder: string[] = [ "welcome", - "systemspecs", - "installation", "gettingconnected", - "workingwithsessions", + "makingmeetings", "dashboard", "localization", "faq", "plans", - "changelog", ] diff --git a/src/content/docs/en/faq.mdx b/src/content/docs/en/faq.mdx index cb39f21..ec08d43 100644 --- a/src/content/docs/en/faq.mdx +++ b/src/content/docs/en/faq.mdx @@ -1,124 +1,139 @@ ---- -title: Frequently Asked Questions ---- - -import Windows from "~/components/platform/Windows.astro" -import MacOS from "~/components/platform/MacOS.astro" - -Here are answers to some common questions concerning RIM. When faced with an issue, please refer to this document whenever possible. If your question is not covered in this document, please [Contact us.](https://pneumasolutions.com/contact/) -## Compatibility -### What Windows versions are supported? -We support Windows7SP1 and above, as well as Windows Server2012 and up. -### What Mac OS versions(s) are supported? -RIM supports Mac OS Ventura along with future versions, be they Intel or Apple Silicon. You as a Mac user can provide support to Windows targets, and Windows users can provide support to your Mac. -### What about Mac OS versions before Ventura? -Some features of RIM depend on functionality newly introduced in Ventura, making compatibility with previous versions difficult to implement. -## Installation -### Why so many permissions requests on Mac OS? -This is unfortunately beyond our control, as Mac OS requires that we use their avenues for requesting the necessary permissions needed for RIM. We have no control over the UX, so can only go as far as providing as much instruction as we can. -## Connection Information -### Generally speaking, how responsive is RIM? -The roundtrip latency during an RIM session is extremely minimal. Because we don't rely on a central service, most of the time your connections are direct from one computer to another - this is what is known as peer-to-peer. If your network configuration doesn't allow for peer-to-peer connections, we fall back to any number of relays located around the world rather than relying on one central server. Thus, even then your latency will still be farely minimal. -### Where are your relays located? -Currently, we offer relays in the following locations: -* U.S. - * Virginia - * California -* Teronto, Canada -* London, England -* Warsaw, Poland -* Bangalore, India -* Singapore -* Sidney, Australia -* Sao Paulo, Brazil - -## General Session Troubleshooting -### The target machine to which I am connected doesn't respond properly to keyboard commands that work fine on my keyboard. What's going on? -This could be due to either one of these possibilities: -* A conflict in keyboard layouts: On rare occasions, if a keyboard layout is different enough from your own it may confuse RIM. Should that occur, please contact us with a report containing information about the keyboard layout of both machines. -* If the target machine is using JAWS 2024, its unified keyboard processing sometimes interferes with use of the CTRL key for silencing speech. Although we deployed a fix for this, issues sometimes may still arise. - * This issue can be resolved by disabling unified keyboard processing in the JAWS settings center. - * Unified keyboard processing is not necessary if the target user is not also using ZoomText or Fusion. -* If the target machine is using NVDA and has "Handle keys from other applications" unchecked, RIM will not be able to process keyboard input from the controller. - * Note that this setting is on by default, and in most cases it is advisable to leave it on. - -### When starting a voice conversation on Windows, RIM uses the internal microphone no matter which microphone I select in sound settings. What's wrong? - -This may be due to the Intel® Smart Sound Technology for Digital Microphones on some newer Intel processors. Disabling this should fix the issue. In order to disable Intel® Smart Sound Technology for Digital Microphones, do the following: -1. Go to the run box (Windows+R). -1. Type devmgmt.msc -1. In the devices tree, expand "Sound, Video and Game Controllers." -1. Right click on "Intel® Smart Sound Technology for Digital Microphones." Choose "Disable Device" from the context menu. - -### The target is using Zoom Text. How do I experience the visual output as rendered by this magnification? - -This is accomplished by switching ZoomText to compatibility mode. This mode allows screen enhancements to be shared via tools like Teams or Zoom, as well as RIM. You can activate it via the ZoomText menu: Help > Advance > Display adapter. In the open dialog, select compatibility mode, and ZoomText will restart. We recommend switching the Display adapter back to its regular mode after the RIM session is complete for optimal performance and magnification quality. - -### After a computer is reimaged and has been reconfigured with the same computer name, is there anything that needs to be done to get RIM up and running again? -Simply remove the machine from your account, reinstall RIM, then add the machine back into your account. - -## Pricing and Payments -### So, getting help from a person over RIM is totally free, right? -You bet! The subscriptions and/or one-off payments are for individuals and organizations seeking to offer remote assistance. No need to worry about getting a subscription if you're the person receiving help. In fact, you do not even have to set up an account if you are merely receiving help. -### I don't really do remote assistance regularly, but I may be helping a friend or family member on occasion. Are there any options that don't involve a subscription? -Certainly! We do accommodate as many use cases as we can. -* Anyone can assist a user over RIM for free for up to 30 minutes a day. So if you need to help someone install some software, fix a problem real quick, or send over a few files, we've got you covered. These minutes don't have to be used in one sitting. -* There are, of course, going to be situations where a particular issue requires a little more time. Or maybe you're assisting someone learning a new piece of software and might be connecting on and off over the next few days. That's where our day passes and incident passes come in. - * Incident passes allow you to connect to a single target as many times as is needed over a 24 hour period. - * Day passes allow you to connect to multiple targets over a 24 hour period. - * Packages of prepaid hours allow you to have a set number of hours available to be used entirely on your own time. -* You can accumulate several of these passes and hourly packages and use them whenever the time calls for them. If you have multiple day passes, for instance, you do not need to use them consecutively. Similarly, You don't need to use your prepaid hours in one session or 24 hour period. - -### I purchased a package of prepaid hours. What happens to my free daily allotment? -Good news: Your free 30 minute daily allotment is not going anywhere! When you start a keyword-based session, RIM will start off by using your free 30 minute daily allotment. Your prepaid time will be used after your free 30 minutes is up. -### How long will my prepaid hours last? Are they tied in with my subscription? -Prepaid hours are entirely separate from your subscription. That being said, your prepaid hours will remain in your account for one (1) year past the date they were first used. -### How do I go about bringing RIM to the attention of my place of work? -We've assembled a [Self-Advocacy Kit](https://sak.getrim.app) (SAK). A packet of e-mail formatted letters you can send to appropriate individuals on behalf of yourself or an employee. For the record, RIM provides the same functionality as less accessible mainstream solutions. As such, RIM can replace an existing infrastructure, rather than be used alongside one. It is therefore considered a reasonable accessibility accommodation and should be provided to you by your organization. Accessibility isn't a favor, it's a right to inclusivity. -### What payment methods do you accept? -We process payments through FastSpring, so we are able to directly accept a variety of international payment methods including major credit cards, PayPal, Alipay, and many more. - -### How do these passes work? Does the clock start immediately upon payment, or on the day I initiate the session? -Passes only begin when the controller initiates the session. So if the target's machine fails on them requiring a trip to the shop and a same-day turnaround is not possible, you can simply hold off until the machine is back in good shape and your day pass will still be waiting for you. -### So this means these passes don't expire? -No. Rest assured that your accumulation of day passes will be waiting patiently for you to activate them whenever you're ready. -### What happens if I connect to another machine on the day an incident pass has been used? -That depends. If the machine is within your subscription, I.E. if you're accessing your home machine while on the road, then it's business as usual. Any other connections that aren't the initial target you connected to will work under the usual 30 minute allotment. -### I hold an active personal subscription. Would I still be able to assist a user outside the group of targets for up to 30 minutes, or via a pass? -Yes! Your 30 minute daily allotment is still present for any machine outside of your subscription. Additionally, acquiring a subscription does not replace any existing passes you may have. -### I have a personal subscription, and the target computer underwent a hardware upgrade. Will Rim count this as a machine switch? -Only if RIM needs to be reinstalled. So, while a hard drive upgrade or any other situation requiring a Windows reinstallation would be considered a machine switch, upgrading the ram would not. -### Our company bought the pro subscription, but we have two techs - one that does help-desk during the day, and a system maintenance tech that works in the evening. Would we be able to assign the evening sysadmin a controller seat? -Definitely. In situations where multiple technitions will be using RIM, we offer up to two (2) additional controller seats for $50 a month per seat - $500 a year per seat - to accompany the pro plan if needed. This will make it easier for multiple controllers at different workstations or offices to provide remote support. -If you have multiple controller seats, you can purchase additional channels for them so that sessions can run simultaneously. Each additional channel is $50 a month, or $500 a year. - -## Security -### Are RIM sessions encrypted? -Yes. All sessions across all platforms, be they direct peer-to-peer connections or connections using a relay, are encrypted end to end using Datagram Transport Layer Security (DTLS). This is the same technology seen in the HTTPS protocol that modern websites implement for security. -### Can Pneuma Solutions eavesdrop on sessions relayed by the public cloud? -No. Session key negotiation and encryption are performed end to end between the controller and the target. In other words, everything is encrypted before it even leaves your device. That way, the cloud service merely relays the data as is, making it impossible for the service to decipher the data. -### What measures have been taken to prevent remote code execution (RCE) vulnerabilities? -All RIM code which is exposed to input from the network is written in [memory-safe programming languages](https://www.memorysafety.org/docs/memory-safety/) including Rust and JavaScript. -### Is RIM HIPAA-compliant? -Yes. The best configuration in this case would be an on-premises deployment, so please [get in touch with us](https://pneumasolutions.com/contact/) if your use case depends on this. -### Do any ports need to be opened on the target or controller? -No and no. -### What connections would need to be allowed on a network in order for RIM to function? -When utilizing the public cloud, an https connection to [getrim.app](https://getrim.app) is required. In optimal cases this is enough for RIM to establish a peer-to-peer connection between the controller and the target. However, it helps to allow UDP connections through ports 19302 and 3478 (the standard STUN and TURN ports). This ensures that if a relay is being utilized, RIM will not have to fall back to a tcp connection on port 443. -### Does RIM run in the background, and if so will it appear in my Command+Tab list? -RIM runs in the background in order to process automatic updates, receive unattended/prompted connection requests, and enable use of the global Option+Shift+Backspace keyboard command. It will not phone home for any other purpose, and no personally identifiable information is transferred. -RIM will not appear in your Command+Tab list, but it will appear in the status menus that contain your battery, WiFi connection information, etc. -## Remote Accessibility Module -### Is there anything the target machine needs to configure for first-time use of the Remote Accessibility Module? -Not at all! There are no dialogue boxes, permission request screens or anything of the sort. -### Does the Remote Accessibility Module work on secure screens such as the lock screen? -Yes! Since the RIM host runs with elevated privileges, this allows us to leverage the Remote Accessibility Module for secure screens. The only exception to this is FileVault's logon window. -## Unattended Sessions -### Are voice conversations supported during unattended sessions? -No. However, prompted sessions do support voice conversations. -### If I delete an unattended machine from my controller account, will it automatically revoke permission on the target? -Yes. Once an unattended target is removed, the change will be effective immediately. If the target machine is powered down or otherwise not connected to the internet, the change will be effective as soon as an internet connection is established on their machine. -### The target machine rebooted after installing updates and drivers, and it requires a password to log in. How does the session continue from here? -In most instances, particularly when FileVault disk encryption is enabled, the target user will need to manually enter the password. RIM cannot start on an encrypted Mac before it has been fully logged in. -### I have multiple machines playing the part of the controller. Will the list of machines set up for unattended access populate across all machines? -Yes. The list of machines configured for unattended access is stored within your account, so it will populate automatically. +import { MacOS, Windows } from '@/../components/platform' + +# Frequently Asked Questions + +Here are answers to some common questions concerning RIM. When faced with an issue, please refer to this document whenever possible. +Don’t see your question? [Contact us.](https://pneumasolutions.com/contact/), and let’s get you squared away. + +## What is Scribe for Meetings? + +Scribe for Meetings is a cloud-based technology that takes a shared presentation on platforms like Zoom, Microsoft Teams, Google Meet, and others and renders it into an accessible presentation in real time for print-impaired individuals. + +## Who benefits from Scribe for Meetings? + +First and most importantly, the millions of print-impaired persons who would otherwise not benefit from the information being presented; and, the masses of businesses large and small, government agencies, all levels of education,, and organizations who know little about accessibility but would like an affordable means of making their content more inclusive. + +## Why should I choose Scribe for Meetings over other products? + +We’re confident there is nothing else out there that does what we do quite the way we do it. Scribe for Meetings is the first technology of its kind to synchronize with meeting platforms in real time. Sure, competitors will take note and likely roll out their imitations, and we look forward to the competition ,but unless they plan on competing on price, we feel confident you will find what you need right here. + +## How does Scribe for Meetings work? + +If you are the host: +1. Visit [ScribeForMeetings.com,](https://scribeformeetings.com) paste the invite link for your meeting, and press “Go”. +1. Click the button to register your meeting. +1. If prompted, enter your email address to log in. If you’re using Scribe for Meetings on behalf of an organization, make sure to use your email address provided by that organization. If your organization has integrated Scribe for Meetings with a single sign-on (SSO) system, then you’ll be taken to the normal login process for your organization, or possibly logged in automatically. Otherwise, we’ll send you an email with a link that you can use to log into Scribe for Meetings. +1. Enter a name for your meeting, select your PowerPoint slide deck, and press “Submit”. + NOTE: Scribe for Meetings currently supports Zoom meetings, Zoom webinars and Microsoft Teams. Sign up to our email list to receive a notification when we add features and additional meeting platforms. + +Your content will be ready to launch within minutes. No knowledge of creating accessible presentations is required. As the host, you don’t need to run extra software on your device, and content can be uploaded as little as 5 minutes before the meeting. +For the print-impaired meeting attendee, navigate to https://www.ScribeForMeetings.com, paste in your Zoom or Microsoft Teams invite link, and press “Go”. Alternatively, your meeting host might have given you a direct link to Scribe for Meetings, either in the invitation email or in the meeting itself via chat. Whichever way you get there, you’re now ready to follow along with the presentation in any web browser on any platform. + +## How difficult is it to install Scribe for Meetings? + +Scribe for Meetings is not an installed application. It is a cloud service, so nothing more than a browser is needed to enjoy a meeting. For presenters, Other than uploading their content in advance of the meeting, the process was intentionally designed to be simple. There is nothing to install to your computer or device other than Zoom, Microsoft Teams or similar meeting platforms. +Enterprise customers can host Scribe for Meetings on their own servers. Please get in touch with us for details. + +## I see an attendee named “Scribe for Meetings” trying to join my meeting. What’s going on? + +That’s the Scribe bot. This bot watches the screen in your meeting, so it can see what slide is currently being displayed and provide the accessible version of that slide in real time to print-impaired attendees. The Scribe bot will not disrupt your meeting in any way, and it will not collect any information other than what content is currently being displayed through screen sharing. If your meeting has a waiting room, please promptly admit the Scribe bot into the meeting. Otherwise, Scribe for Meetings will not work. + +## I’m a print-impaired meeting attendee, and I don’t know if the meeting I’m attending has been registered through Scribe for Meetings. What can I do? + +Go to [ScribeForMeetings.com](https://scribeformeetings.com), paste in the Zoom or Microsoft Teams invite link for your meeting, and press “Go”. If the meeting has been registered with Scribe for Meetings, then you’re ready to follow along with accessible slides. If not, you can sign up to be notified by email when the meeting has been registered with Scribe for Meetings. + +## I frequently attend Zoom or Microsoft Teams meetings. What’s the easiest way for me to find out if a meeting is registered with Scribe for Meetings, and if it is, view the accessible content? + +Scribe for Meetings has an [extension for Chrome and Edge](https://chrome.google.com/webstore/detail/scribe-for-meetings/bikolphfhfiambndbiimigilhfekcfpn) that checks the availability on Scribe for Meetings of any Zoom or Microsoft Teams meeting you attend. With a single hotkey, you can view the accessible content if the meeting is registered, or request a follow-up notification if the meeting is registered with Scribe for Meetings later. + +## I’m a print-impaired meeting attendee. Do you have any resources to help me ask the meeting host to use Scribe for Meetings? + +Yes; check out our [Scribe for Meetings Self-Advocacy Kit](https://sak.scribeformeetings.com). Here you’ll find a variety of pre-written letters that you can personalize, then copy and paste into an email. + +## Can Scribe for Meetings convert a presentation to accessible file formats for offline viewing? + +Yes. When creating the meeting, the presenter can optionally choose to provide their presentation for downloading in the following file formats: +* An accessible web page, with all of the same features as the live presentation, including read aloud +* Tagged PDF +* MP3, via text-to-speech in about a dozen languages +* DAISY, text plus audio +* EPUB +* Microsoft Word +* Braille: Grade 1, Grade 2, Unified English Braille, and many other languages + +The PDF and Microsoft Word options support large print. This option, and other options such as speaking rate for audio output, can be chosen by attendees when they download the slides. +This feature is not enabled by default; the presenter must choose to allow it. To enable this feature when registering a meeting, check the checkbox called “Allow attendees to download accessible versions of slides.” This choice will only take effect for the meeting currently being registered. +For a meeting where this feature is enabled, as soon as the presenter has shown a slide, the web page where attendees view accessible slides will include a link called “Download Slides”. To download the slides, an attendee should follow these steps: +1. Click the “Download Slides” link. +1. If prompted, enter your email address and follow the instructions to log in. +1. Choose the accessible format you want. +1. For some formats, you can optionally customize settings, such as text-to-speech voice, speaking rate, braille translation table, or large print. +1. Click the “Prepare Download” button. +1. Watch your email for the download link. For most formats, the email will arrive within a few minutes. Conversion to audio can take much longer, depending on the length of the slide deck, because speech synthesis is a more time-consuming process than other conversions. + +## I host many meetings, and I want to allow my attendees to download the slides for all of these meetings. Can I turn this feature on by default? + +Yes. Follow these steps: +1. +Go to ScribeForMeetings.com. +1. If there’s a “Log In” link at the top of the page, click it, enter your email address, and follow the instructions to log into Scribe for Meetings. +1. Click “Settings”, then “Meeting Defaults”. +1. Check the checkbox called “Allow attendees to download accessible versions of slides”, then click “Save”. + +## I want to protect my slides from unauthorized copying and distribution. Does Scribe for Meetings support this? + +Unfortunately, Scribe for Meetings cannot stop your attendees from copying the text of your slides. However, if you don’t allow the slides to be downloaded, it won’t be easy for attendees to copy your slides, because they will have to copy one slide at a time. Also, note that in practice, this is no different from what any attendee can already do by taking screenshots of your slides. + +## Is Scribe for Meetings multilingual? + +Yes. Scribe for Meetings can render content in any of 140 languages, again with no extra effort from the presenter. + +## Do I need to slow down my presentation to make sure that print-impaired attendees can keep up? + +No. Scribe for Meetings has a feature called Dynamic Visual Representation, or DVR mode for short, that allows print-impaired attendees to read your accessible slides at their own pace. An attendee can pause the live presentation, go back to a slide they’ve already read, move forward at their own pace, and then continue with the live presentation when they’re ready. +To use DVR mode, the attendee should press either the Suspend Presentation button or the Previous Slide button. These buttons are labeled as such for screen reader users, and for mouse users who hover over them. Visually, they’re at the bottom of the page and look like the Pause and Previous Track buttons in a media player. When the user presses one of these buttons, the live presentation will pause, and for the Previous Slide button, it will return to the previous slide. The user can then use the Previous Slide and Next Slide buttons to go through the slides at their own pace, and the Go Live button to return to the live presentation. These buttons look like the Previous Track, Next Track, and Play buttons in a media player. +Note that DVR mode only allows attendees to review slides that have been shown since they joined the presentation. If a print-impaired attendee is late for your presentation, then they missed the same slides that any other late attendee would have missed. + +## I have a print-impaired attendee who would benefit from having my content spoken aloud but isn’t comfortable with a full screen reader. Can Scribe for Meetings help? + +Yes. Our Read Aloud feature will speak your slides using the voices provided by your user’s device and web browser, while drawing a box around each word as it is spoken to help the user follow along visually. For Windows users, we highly recommend the Microsoft Edge browser for this feature, because Edge offers outstanding voices in several languages, free of charge. However, this feature also works with all other major platforms and browsers, including mobile devices. +To start reading the current slide aloud, press the Read Aloud button, which is at the bottom of the screen and looks like a speaker. While Scribe for Meetings is reading the slide aloud, it will show controls to stop reading (the button with a square icon), pause or resume, go back or forward (the buttons that look like Previous Track and Next Track buttons in a media player), speed up and slow down reading, or change the voice. These controls will go away as soon as reading is finished or as soon as the user stops it. +Note that Read Aloud and DVR mode (see above) can be used together, to allow print-impaired attendees to read slides both in their own way and at their own pace. + +## I have a print-impaired attendee who needs my slides in a large font but doesn’t need a full-screen magnification program. Can Scribe for Meetings help? + +Yes. Scribe for Meetings displays your slides in a way that makes them accessible for attendees with all types of content requirements. If large fonts are needed, an attendee can use their browser’s page zoom feature to adjust the font size of the slides, without requiring the user to continually scroll back and forth. Scribe for Meetings will also automatically display the text in the user’s preferred color scheme, whether it’s the usual dark-on-light, light-on-dark (also known as dark mode), or a custom scheme. + +## Wait! What’s going on here? Why do my slides look so different in Scribe for Meetings than they do in my presentation? + +Every aspect of how Scribe for Meetings displays your slides is optimized for accessibility, for attendees with all types of print impairments. Since Scribe for Meetings is meant to be used alongside your existing meeting platform, attendees are always free to flip back to the main meeting window to see the slides as they’re displayed in your presentation without accessibility. + +## I don’t use PowerPoint. Can I still make my presentation accessible with Scribe for Meetings? + +Scribe for Meetings can make your screen-shared slides accessible no matter what app you use to present them, as long as you can provide your slide deck in PowerPoint format. Other presentation apps such as Keynote and Google Slides can convert their slide decks to PowerPoint format, so you can use these with Scribe for Meetings. + +## Scribe for Meetings isn’t showing the accessible versions of my slides during the presentation, or it’s skipping some slides. What’s wrong? + +Make sure that you’re presenting your slides in a full-screen slide show, and that you’ve set up Zoom or Microsoft Teams screen sharing to share that slide show with your audience. If you’re using PowerPoint for Windows to run your presentation, then once you’ve opened PowerPoint, make sure you press F5 to enter slide show mode. +[Learn more about how to use Zoom screen sharing with PowerPoint.](https://support.zoom.us/hc/en-us/articles/203395347-Screen-Sharing-a-PowerPoint-Presentation) +[Learn how to use Microsoft Teams screen sharing with PowerPoint.](https://support.microsoft.com/en-us/office/share-powerpoint-slides-in-a-teams-meeting-fc5a5394-2159-419c-bc59-1f64c1f4e470) + +## How does Scribe for Meetings handle pictures and graphics in my slides? + +If you already wrote descriptions (also known as alt tags or captions) for the graphical content in your slides, Scribe for Meetings will use those. Otherwise, Scribe for Meetings will use a cloud-based image description service powered by machine learning to automatically add alt tags for your graphics. If those pictures contain text, Scribe for Meetings will also use optical character recognition (OCR) to make that text accessible. + +## My slides have charts, diagrams, or other complex graphics. Can Scribe for Meetings handle them? + +The short answer is, not for the most part. We’re still working on this. Because the Scribe Augmented Document Remediation platform is powered by machine learning, as we receive more documents and slide decks with complex graphics, we’ll be able to train our model to make those graphics accessible. But, for now, you’ll just have to try it and see. + +## Does Scribe for Meetings work with meeting platforms other than Zoom and Microsoft Teams, like Jitsi Meet, Google Meet, Slack, Amazon Chime, or BlueJeans? + +Not yet, but it will soon. + +## How do people within our organization log into Scribe for Meetings? + +Scribe for Meetings currently supports two options for authentication. The simplest option is our email-based login process. Just enter your email address, and we’ll send a link that you can use to log in; no password is needed. For organizations with more stringent security requirements, we can also integrate with single sign-on (SSO) systems that implement the SAML standard, either via the [InCommon](https://www.incommon.org/) federation or using bilateral metadata exchange. Our SAML service provider uses the open-source Shibboleth SP package and was implemented in partnership with [Signet, Inc.,](https://www.signet.id/) an identity management and access control firm founded by an architect of Shibboleth. Note that we support SSO through a variety of identity providers; in addition to Shibboleth IdP, we’ve tested with Azure Active Directory. When your organization signs up with Scribe for Meetings, we’ll offer SSO onboarding, covered by the setup fee. + +## What is the future of Scribe for Meetings? + +Scribe, the platform behind our Scribe line of products, is actively learning every time a document is processed. The machine learning powered Augmented Document Remediation technology gets smarter with each page, moving us that much closer to 100% accuracy. The benefits spill over into all our products, making Scribe for Meetings an application that will only get better the more you use it. \ No newline at end of file diff --git a/src/content/docs/en/gettingconnected.mdx b/src/content/docs/en/gettingconnected.mdx index fb52624..5f7b372 100644 --- a/src/content/docs/en/gettingconnected.mdx +++ b/src/content/docs/en/gettingconnected.mdx @@ -1,28 +1,17 @@ ---- -title: Getting Connected ---- +import { MacOS, Windows } from '@/../components/platform' -import Windows from "~/components/platform/Windows.astro" -import MacOS from "~/components/platform/MacOS.astro" +# Getting Connected -Remote Incident Manager's connection process is designed with speed and simplicity in mind, both for the person receiving assistance as well as for the person providing it. -## Connecting to a Controller -When you first launch Remote Incident Manager, you will be in target mode by default. This means that you are going to be connecting to a person who has set up a remote support session for you. -You will land in an edit box labeled "keyword." Enter the keyword issued to you by the person assisting you, and then simply hit enter. That's it, you're connected! -## Accepting a Request to Connect -If a technician provides support to you on the regular, your machine may be set up to receive a request to connect without either of you having to enter a keyword. RIM will play a chime, then announce that your technician is attempting to connect. -In order to accept the connection, press **Windows+Shift+Y** and the session will begin momentarily. -In order to accept the connection, press **Option+Shift+Y** and the session will begin momentarily. -## Connecting to a Target -The process for setting up the session is fairly similar. Rather than entering the keyword, you will want to navigate to the "Provide help instead" button. When doing this for the first time, you will be asked to set up an account. -1. Enter your email address. -1. Check your email for a verification code, and then enter it into RIM. -1. You will then be asked to enter your name, location and phone number. -1. Lastly, you will receive another verification code on your phone. Enter this code into RIM. - 1. If you do not have a mobile phone capable of receiving text messages, please fill out this form. We will assist you in getting your account verified. - 1. A note for international numbers: If your verification code doesn't come through, make sure the country code before your number is denoted by the plus sign, rather than 00. +Scribe for Meetings offers several quick, painless ways to connect to your accessible slide presentation. -Now that you're logged in, enter the keyword that the target will use to connect to you. When you navigate past the edit box, you will come across a checkbox that determines whether or not to start a voice conversation during the session (this can be toggled on or off during the session as well). After that, you will find the "Start" button. When you click this, you will be in the waiting room until your target connects. At this point, you will want to send the keyword you just entered to the person you'll be connecting to, as this is what they will use to connect. Once they have connected, you will receive an alert informing you that the remote session is about to begin. -Take note of the mentioned **Windows+Shift+Backspace** shortcut as that will bring up the RIM menu on your machine. If you rely on the keyboard exclusively, this is the only way to direct keyboard input back to your own system. -Take note of the mentioned **Option+Shift+Backspace** shortcut as that will bring up the RIM menu on your machine. If you rely on the keyboard exclusively, this is the only way to direct keyboard input back to your own system. -After you dismiss this dialogue, the remote session will be initiated. +## Direct Link + +Similar to a meeting link from your teleconference platform, Scribe for Meetings offers direct links for joining your accessible slide presentation. If you receive one in your meeting invite or the meeting chat, you can click on it to instantly open Scribe for Meetings in your web browser. Once you click the "Start" button, one of two things may happen. +1. You will hear a short chime, followed by a message informing you that Scribe for Meetings is preparing to provide access to the content in this meeting. + 1. It is normal for this to take up to three minutes, hence why it may be advisable for the meeting presenter to initialize Scribe for Meetings in advance of presenting their slides. + 1. Once the Scribe Bot joins the meeting, you will receive a second alert chime followed by a message alerting you of this fact. +1. You may sometimes start hearing slide content being announced very shortly after clicking on "Start." This could happen if: + 1. You are not the first visually impaired participant to enter the meeting. + 1. You entered a meeting late. + +In any case, Scribe for Meetings is now ready to start presenting the slides. \ No newline at end of file diff --git a/src/content/docs/en/makingmeetings.mdx b/src/content/docs/en/makingmeetings.mdx new file mode 100644 index 0000000..d99c269 --- /dev/null +++ b/src/content/docs/en/makingmeetings.mdx @@ -0,0 +1,34 @@ +import { MacOS, Windows } from '@/components/platform' + +# Setting up a Meeting + +Whether done well in advance or within minutes of the meeting's start time, the setup process is quick and efficient. The procedure for starting the meeting will vary slightly depending on your role. + +## If you are the Organizer + +1. Login to your Scribe for Meetings account, if you have not done so already. +1. Enter the invite link for the meeting, then click "Go." +1. You will land on a page informing you that this meeting has yet to be registered with Scribe for Meetings. When asked how you would like to proceed, click on "Click here if you are the organizer of this event." AS you are the event organizer, you will be able to run the registration process through to completion. +1. Enter a meeting title in the "Title" edit box. + 1. Note that this does not have to be the title of the meeting in your video conferencing platform. +1. To upload your slides, click on "Browse…No file selected." A standard file browser window will appear where you can select your PowerPoint or PDF file. + 1. Note: while PowerPoint support is complete, PDF support is currently in beta. +1. These next settings are optional. You may skip past them and click "Done" if desired. + 1. You will be presented a language dropdown, useful if you wish to manually enforce the language instead of using the automatic language detection. + 1. You will be asked if you wish to have images automatically described. + 1. Note that Scribe's image description will only attempt to describe images that lack alt text. + 1. Lastly, you will be asked if you wish to allow the downloading of slides. +1. Once you click "Done," Scribe will process the slides for your meeting. A percentage bar will report progress on this. +1. Once the slides have been processed, you will be given the chance to copy a message containing the Scribe for Meetings participant link to the clipboard. You should post this in the meeting chat, in an email to your participants, or via any other accessible means. +1. Within a few minutes of the participant clicking the link and initiating the join process, the Scribe Bot will attempt to join your meeting. If you have a waiting room, you will need to allow the bot entry into your meeting manually once you receive the alert from your video conferencing platform. In either case, the Scribe Bot will patiently await your screenshare. +1. Launch slideshow mode in your presentation program, then share the slideshow window to your meeting participants. Any meeting participants with Scribe for Meetings loaded in their browser will begin hearing the accessible slides. + +## If you are not the organizer: + +Meetings can be set up on behalf of the organizer, who will then be able to upload the slides. +1. Login to your Scribe for Meetings account, if you have not done so already. +1. Enter the invite link for the meeting, then click "Go." +1. You will land on a page informing you that this meeting has yet to be registered with Scribe for Meetings. When asked how you would like to proceed, click on "Click here if you want to register this event on behalf of the organizer." +1. Give the meeting a title. +1. You will be asked if you wish to have images automatically described. +1. Once you click "Done," you will be given a message that you can copy to your clipboard and send to the person in charge of slides. Once they click the link and upload the slides, they can decide whether or not to allow slides to be downloaded. diff --git a/src/content/docs/en/workingwithsessions.mdx b/src/content/docs/en/workingwithsessions.mdx deleted file mode 100644 index a2dcb37..0000000 --- a/src/content/docs/en/workingwithsessions.mdx +++ /dev/null @@ -1,231 +0,0 @@ ---- -title: Working within a Session ---- - -import Windows from "~/components/platform/Windows.astro" -import MacOS from "~/components/platform/MacOS.astro" - -## Things to Know before you Begin - -A few things will happen immediately after the connection is established. - -- The remote control window for the session will appear. -- You will be informed about the status of the running screen reader, or lack thereof, on the client's machine. -- If the client is running a screen reader, a toast notification informing the user that the remote session has begun will provide instant confirmation that the user's system audio is working. -- A Mac target will pop up the keyboard setup assistant if this is the first time a controller has connected to it. - - This is for the Karabiner virtual keyboard, which listens to keyboard commands sent to it by a controller. - - As such, you will want to walk the target computer through the setup assistant, because it will be listening for remote keyboard presses in the identification process, not the Mac's own keyboard. -- Last but not least, all keyboard and mouse input will immediately be directed to the target computer. To direct control back to your machine, do either of the following: - - Press Windows+Shift+Backspace. - - Right-click the RIM window's title bar. - - Left-click the RIM icon. - - -- The remote control window for the session will appear. -- You will be informed about the status of the running screen reader, or lack thereof, on the client's machine. -- If the client is running a screen reader, a toast notification informing the user that the remote session has begun will provide instant confirmation that the user's system audio is working. -- A Mac target will pop up the keyboard setup assistant if this is the first time a controller has connected to it. - - This is for the Karabiner virtual keyboard, which listens to keyboard commands sent to it by a controller. - - As such, you will want to walk the target computer through the setup assistant, because it will be listening for remote keyboard presses in the identification process, not the Mac's own keyboard. -- Last but not least, all keyboard and mouse input will immediately be directed to the target computer. To direct control back to your machine, do either of the following: - - Press Option+Shift+Backspace. - - Click on the large RIM icon in the upper left-hand corner of the session window. - - -## Remote Control Zone - -At this point, you're all set to perform whatever tasks need doing on the client side. Should you need to switch back to controlling your own machine, bring up the RIM menu, then select the "Minimize session" option. You will be taken back to your machine until you switch back into the session window or press Windows+Shift+Backspace again. When you go back into the session window, keyboard and mouse input will once again be directed to the client computer. - -Once you're done, either the controller or the target can go into the RIM menu and choose the "Disconnect Session" option. When the session ends, the target machine will get a toast notification informing them of this. - -## The RIM Menu - -As mentioned earlier, accessing the RIM menu directs you back to your machine. There are a number of options in this menu. They include: - -- Update RIM on Target: Forces an update of RIM on the target computer - - This option shows if the target's machine is running an older version of RIM. -- Minimize Session (**Windows+Shift+M**): brings control back to your machine as described above -- Transfer File to Target: Appears if a file is on the clipboard. - - Although this alternate method of completing a file transfer is always available, it is only necessary for transferring files to Mac targets. -- Flip Session (**Windows+Shift+F**): Allows your client to remote control your machine and hear its audio. As the original controller, you can flip the session back by selecting this option a second time. -- Start/stop Voice Conversation: Allows you to toggle the voice chat on or off for your session. - - Note that this option is unavailable in unattended sessions as they do not support voice chat. However, prompted sessions still support this. -- Start Remote Accessibility: This option appears when no screen reader is running on the remote computer. This will enable speech on your end, but the client will not need to worry about hearing speech. - - If a screen reader (including Remote Accessibility) is running, this option turns into a force quit for the running screen reader. This is useful when a target's screen reader stops responding to the extent you are unable to restart it normally. -- Reboot and Reconnect: Allows you to reboot the computer and automatically reconnect the session. - - Note that a Mac target cannot start RIM pre-login due to platform limitations, notably FileVault. - - As such, RIM will reconnect once the user logs in. -- Send Control+Alt+Delete: Sends this keystroke to the remote machine. - - An equivalent for this option is not yet implemented for Mac targets. -- Request Unattended or Prompted Access: Allows you to send a request for unattended access to the client computer. This is useful if you are a sysadmin and need to perform routine maintenance, or even for something as simple as controlling your home machine while on the go. -- Lock the Target Machine: Locks the target machine. -- View Connection Details: Provides a detailed lowdown on your connection, as well as the target machine. Information includes: - - Connection statistics - - Information about the computer, including operating system version, available RAM, etc. - - Running processes (Windows targets) - - Installed packages (Windows targets) -- Disconnect Session (**Windows+Shift+D**): Terminates the session. - - Remember that this option is available to both sides of the session. - - -- Update RIM on Target: Forces an update of RIM on the target computer - - This option shows if the target's machine is running an older version of RIM. -- Minimize Session (**Option+Shift+M**): brings control back to your machine as described above -- Transfer File to Target: Appears if a file is on the clipboard. - - Although this alternate method of completing a file transfer is always available, it is only necessary for transferring files to Mac targets. -- Flip Session (**Option+Shift+F**): Allows your client to remote control your machine and hear its audio. As the original controller, you can flip the session back by selecting this option a second time. -- Start/stop Voice Conversation: Allows you to toggle the voice chat on or off for your session. - - Note that this option is unavailable in unattended sessions as they do not support voice chat. However, prompted sessions still support this. -- Start Remote Accessibility: This option appears when no screen reader is running on the remote computer. This will enable speech on your end, but the client will not need to worry about hearing speech. - - If a screen reader (including Remote Accessibility) is running, this option turns into a force quit for the running screen reader. This is useful when a target's screen reader stops responding to the extent you are unable to restart it normally. -- Reboot and Reconnect: Allows you to reboot the computer and automatically reconnect the session. - - Note that a Mac target cannot start RIM pre-login due to platform limitations, notably FileVault. - - As such, RIM will reconnect once the user logs in. -- Send Control+Alt+Delete: Sends this keystroke to the remote machine. - - An equivalent for this option is not yet implemented for Mac targets. -- Request Unattended or Prompted Access: Allows you to send a request for unattended access to the client computer. This is useful if you are a sysadmin and need to perform routine maintenance, or even for something as simple as controlling your home machine while on the go. -- Lock the Target Machine: Locks the target machine. -- View Connection Details: Provides a detailed lowdown on your connection, as well as the target machine. Information includes: - - Connection statistics - - Information about the computer, including operating system version, available RAM, etc. - - Running processes (Windows targets) - - Installed packages (Windows targets) -- Disconnect Session (**Option+Shift+D**): Terminates the session. - - Remember that this option is available to both sides of the session. - - -## File Transfers - -RIM provides a simple avenue for transferring files, irrespective of the platform used. -1. Bring up the RIM menu, and click on "Minimize Session." Control will be directed back to your computer. -1. Select the file(s) and/or folder(s) you want to transfer using your file manager. -1. Copy the selected contents to the clipboard in the usual way. You will receive a notification that a file is ready to be transferred. You have two options. -1. **If the target is a Mac:** - - Activate the RIM session menu and click on the "Transfer File to Target" option. - - Upon completion of the transfer, the target Mac will generate a temporary directory containing the transferred contents. These should then be copied and pasted to their intended directories. -1. **If the target is a Windows machine:** - - Switch back to the remote session and locate the folder on the target machine where you wish to paste the content. - - Last but not least, paste as you normally would. - -Note that the transfer time will depend entirely on the size of the content being sent as well as your network speed. - -## Remote Accessibility Module - -Whether you're assisting a user who doesn't use a screen reader, or you're diagnosing an issue with a malfunctioning screen reader, RIM is fully prepared to come to your aid. - -The remote accessibility module consists of two components: -- An addon for the NVDA screen reader that enables the screen reader to receive output from the remote computer -- A self-contained accessibility module initiated on the target computer at the request of the controller. The advantage to this approach is that the end user does not hear speech on their computer while you're controlling it. Instead, the Remote Accessibility Module pipes the speech output through to the running copy of NVDA on the controller side. This way, you can accessibly assist an end user without them having to install or even download a screen reader. -### Setup Procedure -For first-time initialization of the accessibility module, here is what you will need to do: -1. Connect to a computer that does not have a screen reader running. -1. If NVDA is currently running, you will be asked to install an addon that will allow your copy of NVDA to communicate with the remote computer during the session. Accept the installation prompts, and wait for NVDA to restart. -1. By now, the remote accessibility module will be fully initialized, and you will hear speech output as you control the remote computer. - -From this point forward, if you are running a screen reader on the controling computer, the remote accessibility module will automatically start during remote sessions in which the remote computer does not have a screen reader running. Should you be running a screen reader other than NVDA, RIM will disengage that screen reader and then switch you over to NVDA. If you need to stop the remote accessibility module on the remote machine in order to start another screen reader, simply access the "Stop Remote Accessibility" option off the RIM menu. - - -The remote accessibility module is a special configuration initiated on the target Mac at the request of a Windows or Mac controller. The advantage to this approach is that the end user does not hear speech on their computer while you're controlling it. Instead, the Remote Accessibility Module pipes the speech output through to the speech system on the controller side. This way, you can accessibly assist an end user without them having to enable a screen reader. If you are running VoiceOver on the controling Mac, the remote accessibility module will automatically start during remote sessions in which the remote computer does not have a screen reader running. - -## Rebooting and Reconnecting - -Whether you're installing system updates or working your way out of a system hang, RIM has got you covered during the reboot process. Selecting the "Reboot and Reconnect" option off the RIM menu will allow you to either perform a graceful reboot or an emergency reboot, depending on what state the computer is in. While the computer is rebooting, RIM will inform you that reconnection attempts are being made. -Note that if the computer is rebooted by a software installation or manually rebooted in the usual way, you will be asked if you wish to reconnect the session. Of further note is that in either case, Mac targets will only reconnect once the user logs in. This is due to the fact that RIM cannot start automatically on the login screen due to platform limitations, most notably FileVault disk encryption. -## Unattended or Prompted Access - -RIM allows you, as the controller, to configure machines for unattended or prompted access. This allows you to provide remote assistance without the user having to launch RIM, enter a keyword, or even be near the computer. This is useful if you are a sysadmin performing routine maintenance on computers in your workgroup, or for clients you provide support to on the regular. You may also want to allow unattended access for your home computer should you need to access it from someplace else. -There are a few ways to configure machines for unattended access. -### During an Interactive Session - -1. Bring up the RIM menu. -1. Select "Request Unattended or Prompted Access." -1. You will be asked what kind of connection you want to configure. Your options are: - 1. Unattended: Allows sessions to be initiated without any intervention whatsoever from the end user. - 1. Prompted: This configuration presents the user with a prompt informing them that you are conecting to their machine. They will need to press Option+Shift+Y on macOS, or Windows+Shift+Y on Windows, should they wish to accept the connection. -1. You will be asked to give this machine a name. Enter a personal name for the machine, or if applicable, the machine ID as it appears in your workgroup. -1. Press enter. -1. On the client machine, a dialogue pops up asking the user if they're fine with their computer being set up for the access you requested. If they answer yes, then you will get a prompt informing you that the access has been approved. -#### Note for Personal Unattended Account Holders - -If you have used all the machine slots allocated to your account, RIM will not perform the request. In this situation, you have two options, both possible via the RIM Dashboard: -1. Deregister one of your machines, freeing up a slot. -1. Upgrade your subscription with more slots. - -### Registering a Machine to your RIM account - -Should you wish to register one of your own machines for unattended access, you can do so without having to start an interactive session with the machine. -1. Start RIM in Receive Help Mode. -1. Click on the "Add this machine to your RIM account" button. -1. Enter your email, then click next. -1. Wait for the two-step login code to arrive, enter it, then you should be logged in. -1. You will be asked what type of access you would like configured for this machine. Your options are: - 1. Unattended: Allows sessions to be initiated without any intervention whatsoever from the end user. - 1. Prompted: This configuration presents the user with a prompt informing them that you are conecting to their machine. -1. Give the machine a name, then activate the "Add Machine" button. -1. The machine will be registered to your account, which will allow any controller machines logged into your RIM account to connect to this machine. -#### Note for Personal Unattended Account Holders - -If you have used all the machine slots allocated to your account, RIM will not perform the request. In this situation, you have two options, both possible via the RIM Dashboard: -1. Deregister one of your machines, freeing up a slot. -1. Upgrade your subscription with more slots. -### Getting Connected - -Now that we've registered the machine for unattended access, here is how we will start a session. -1. Start RIM in controller mode. -1. Rather than entering a keyword, locate and activate the"Choose a machine" button. -1. When you click this, a list of machines will appear. Choose the one you want, then hit enter. You may also use the search bar to narrow the list down to a specific machine. - -If the target machine is configured for prompted access, the end user will get a prompt. Once they answer yes, you'll be connected. If the session is unattended, you will immediately be connected and dropped into the remote control zone. - -Please note: Voice conversations are not supported during fully unattended sessions, however they are supported for prompted sessions. -### Creating a Shortcut for an Unattended Session - -For extra convenience, you can create desktop shortcuts that allow you to automatically launch unattended sessions. In order to do this: -1. Access the list of unattended computers, and select the one you want to create a shortcut for. -1. Click on the "Create Shortcut" button. -1. A shortcut will be automatically added to your desktop. - -Now, when you activate this shortcut, you will either automatically land in the remote session, or send a prompt to the user's machine that they can accept. - -#### More Ways to use Unattended Session Shortcuts -Unattended session shortcuts, like any other shortcuts, can have global hotkeys associated with them. This can be extremely useful if you are a maintenance tech managing multiple computers in a workgroup. For example, if your workgroup consists of 6 computers that you perform routine maintenance on, you could configure Alt+Control+1 through 6 as hotkeys for each respective machine. This ought to significantly speed up your workflow. -In addition, you can call up an unattended session via the run box if you copy the shortcut into your user directory. Once you've copied the shortcut, you may start an unattended session by typing your-session-name.url in the run box. - -### Revoking Unattended Access - -If you no longer want your machine to be controlled unattended, you can revoke the controller's access. You do not need to be in a session in order to do this. - -1. Access the Remote Incident Manager icon in your system tray. - 1. If using the keyboard, press windows+b, then space, then left or right arrow until you find the icon. -1. Right click this icon, or press the applications or shift+f10 key. -1. Select the "Revoke Unattended Access" option. -1. You will arrive at a list of computers, select the one you want to revoke. -1. You will be asked if you wish to revoke the machine; answer yes. - - -1. Access the Remote Incident Manager icon in your menu extras/status menus. - 1. If using VoiceOver, press VO+M twice, then locate the Remote Incident Manager menu icon. - 1. Click this icon, or press VO+Space. -1. Select the "Revoke Unattended Access" option. -1. You will arrive at a list of computers, select the one you want to revoke. -1. You will be asked if you wish to revoke the machine; answer yes. - -That's it! The controller will receive a message stating that this machine is no longer available for unattended access. Should they need unattended access again, they can reinitiate the procedure to request permission for unattended access as described above. - -## Key Command Reference - -| Action | Command | -| ---------------------------------------- | ------------------- | -| Access the RIM Menu | Windows+Shift+Backspace | -| Minimize Session | Windows+Shift+M | -| Flip Session | Windows+Shift+F | -| Disconnect Session (Controller or Target) | Windows+Shift+D | - - - Action | Command - --- | --- - Access the RIM Menu | Option+Shift+Backspace - Minimize Session | Option+Shift+M - Flip Session | Option+Shift+F - Disconnect Session (Controller or Target) | Option+Shift+D -