Citizen Browser FAQ

• Installing on Mac OS
• Installing on Windows
• Installation Questions
• Received email that my app is not connected
• Instructions for uninstalling the app
• Other Issues
• Privacy FAQ

Application Requirements:
500MB of available hard disk space
Chrome browser installed

Download and Install The App

1. Download the app from the download page.
2. Once downloaded, you will see “Markup Research App” in your downloads folder.
3. Open the file to see the installation screen.
4. On the install screen, drag the “M” icon to the Applications folder.

Registration

1. When the file is finished copying, return to the download page to register.
2. Click on the “Register The App” button.
3. You will see a browser prompt for opening the app, click “Open Markup Research App.”

You might see a warning message that the file was downloaded from the internet, it is safe to click “Open.”

Connecting to Facebook

1. With The Markup Research App window open, you can connect to Facebook.
2. Click on the “Sign In” link. Read the privacy details and then click “I Agree.”
3. Instructions for signing in to Facebook will appear, click “Sign in to Facebook.”
4. A new browser window will launch with the Facebook login screen. Enter your Facebook login credentials.
5. This browser window will close automatically and the application will display a success message.
6. Click on the “Return to Main Menu” link.
7. You will see a confirmation that you have successfully signed in.
8. Follow the instructions on the download page to complete your registration in the study.

Keep the Application Running

1. The application will continue to run in the background when your computer is turned on and connected to the internet.
2. You can confirm the application is running when the “M” icon appears in the top right of the Finder menu bar (near the Wi-Fi icon).
3. If for any reason the “M” does not appear, you can re-open the application from your Applications folder.

Application Requirements:
500MB of available hard disk space
Chrome browser installed

Download and Install The App

1. Download the app from the download page.
2. Once downloaded, you will see  “Markup Research App” on the browser download bar.
3. Open the file to see the installation screen. 

Important: You might see a warning window: “Windows protected your PC.” 

1. Click on the “More Info” link. 
2. A “Run anyway” button will appear, click on this option to proceed. 

Registration

1. When the file is finished copying, return to the download page to register.
2. Click on the “Register The App” button.
3. You will see a browser prompt for opening the app, click on “Open Markup Research App.”

You might see a warning message that the file was downloaded from the internet, it is safe to click “Open.”

Connecting to Facebook

1. With The Markup Research App window open, you can connect to Facebook.
2. Click on the “Sign In” link. Read the privacy details and then click “I Agree.”
3. Instructions for signing in to Facebook will appear, click “Sign in to Facebook”
4. A new browser window will launch with the Facebook login screen. Enter your Facebook login credentials.
5. This browser window will close automatically and the application will display a success message.
6. Click on the “Return to Main Menu” link.
7. You will see a confirmation that you have successfully signed in.
8. Follow the instructions on the download page to complete your registration in the study.

Keep the Application Running

1. The application will continue to run in the background when your computer is turned on and connected to the internet.
2. You can confirm the application is running when the “M” icon appears on the bottom right of your screen in the taskbar.
3. If for any reason the “M” does not appear, you can re-open the application from your Start menu.

I downloaded and installed the application, but nothing happens when I click on “Register the app.”
Once you have downloaded the application, make sure to open “The Markup Research App” from your applications folder. Once you see The Markup Research App window open up, you are ready to register the application.

I tried to register the app, but I got a “We are unable to confirm your registration” error.
If you can submit your auth code to researchappsupport@themarkup.org, we can confirm if your registration went through and you can disregard this error.
Here are the steps to find your auth code:

1. Open the app and click on the "About The App" section 
2. From the menu select "Debug Information" 
3. You will see an Auth Code field. 
4. Copy this number and send it to researchappsupport@themarkup.org

I logged into Facebook, is there something else I am supposed to click?
Once you see that you are connected to Facebook you are done. You can click on “Hide App” in the top left corner of the window.

The window disappeared, did I do something wrong?
The App is running when you see the “M” logo at the top of your screen (Mac) or bottom of your screen (Windows). You can click on this icon to check the status. If the “M” does not appear on your screen, you will need to re-open The Markup Research App from your Applications folder.

You have The Markup Research App set up and registered correctly, but you received an email that your app is not sending data. 

The following steps should resolve the issue:

Is the app still running? 

You should see an “M” icon in your toolbar.

1. For Mac OS this is the top right of the screen.
2. For Windows there are options: 

If you don’t see the icon, you will need to open The Markup Research App.

1. On Mac, you will find the app in your applications folder.
2. On Windows, it can be located in your start menu.

Once the app is open, make sure it is connected to Facebook.

If the app is running, is it still logged in to Facebook?

If the app shows it is not logged into Facebook, you will need to log in again. This should not happen often and we are continuing to make improvements that will prevent users from being automatically logged out.

Has the app been running and connected to Facebook?

If this is the case, please reach out to researchappsupport@themarkup.org and the app developers will help troubleshoot the issue.

Thank you for taking part in The Markup Research App study.

Here are instructions for uninstalling the application.

On Mac:

1. Click on the application 
   1. You can find it by clicking on the M icon on your toolbar
   2. You can also search “Markup Research App” on your computer
2. Click on “Settings”
3. Click on “Uninstall The Markup Research App”
4. This will uninstall all of the files used by the app.
5. Once this is complete, you can drag the application to the trash

On PC:

1. Quit the Markup Research App
2. Press the Windows key
3. Start typing type "add or remove programs". You should see the option to launch the Add or Remove Programs tool. Click it.
4. Find "Markup Research App" in the list (it might help to change the "Sort By" to "Install Date"
5. Choose Uninstall and follow the resulting instructions.

Troubleshooting

Q: I received the error “There was an error deleting your data”

A: The app may have been running a capture when your update occurred causing it to not be able to delete data.. To bypass this error, you will need to restart your computer and open the app again. Once you have the app open, the “Delete data” option should function properly.

I am on Windows and a Chrome browser window logged into Facebook keeps popping up.
The Markup Research App opens a new browser profile on your computer to ensure your privacy. On Windows, this involves opening a new browser tab in Chrome. This should only occur 2-3 times per day and is not intended to interfere with your regular activities.

When the app is opening windows more frequently than usual, it points to a temporary error in the network connection. If this occurs, close the Chrome browser that was started by the application. This should reset the connection to resolve this error.

We are continuing to look into ways to make the app more seamless when these temporary errors are encountered.

If your issue is not covered in this FAQ, please reach out to researchappsupport@themarkup.org and we will do our best to troubleshoot for you.