Skip to content
Karol Putra edited this page Dec 13, 2016 · 5 revisions
### 📘Repo is made for both casual and technical users! Here you can report issues related to all Remix OS products such as: * Remix OS for PC, * Remix OS Player, * Remix Mini, * Remix Ultratablet, * Remix IO/+ * and more...

We want to provide a great feedback system with all issues being public and free to comment by all registered GitHub users.

Our moderators are taking care of keeping the Issues tab clutter free and the engineers review most important or most popular issues on a regular basis.


Issues tab image

The core of Remix OS For PC repository is the Issues tab where you can post or find things like:

  • Hardware related problems;
    • when your WiFi, Bluetooth or dedicated graphics card etc. don't work as intended
  • Bugs in system or 3rd party apps;
    • when something works, but with some glitches or hiccups
  • Requests for new features and better hardware support
  • Suggestions for enhancements to existing features
  • Questions about some features, how the system parts work and other mostly technical subjects
  • Solutions to already solved issues
  • And much more!

Issues tab contains all the reports submitted by users divided into 2 main categories - Open and Closed.

Category containing all new issues and the ones already being dealt with by the community or Jide team. Once an issue is considered solved/outdated/incorrect it can be closed by the issue author or by the repository Collaborators (moderators/Jide team members).

Here you can find all issues considered as solved/outdated/exhausted/etc. Closed issues may contain answers to your questions or solutions to your problems.

The issues tab allows you to view a list of issues with information including: author, labels, milestones and asignees. Asignees are the users with priviledges to maintain the repository - this includes moderators and Jide team members.

Sorting issues Note that the issues list can also be sorted by: date, number of comments, recent updates, number of reactions. It's a very useful tool for determining most popular and important issues. Be sure to use it!

[Searching issues]

  1. Search for both open and closed issues.
  • Use filter is:issue instead of the default is:open/closed is:issue.
  • You can also remove the whole filter, but it will result in showing pull requests too if any exist.
  1. Always exhaust your ideas for search phrases - it will raise your chances of finding what you look for!

If you want to share your thoughts on an issue or "sign" under it - add a comment or a reaction.

This will give the issue better recognition and potential higher priority over other issues.

Add comment reaction


🔴 Please follow the guidelines below, otherwise you will be asked to update the issue accordingly.

Adding issue

  1. Make up your mind

    Are you sure your issue is a thing? It's best to try and reproduce the problem a few times to be certain.

  2. Search

Make sure your problem isn't already solved or reported somewhere out there.

Use the following sources:

  1. Haven't found anything? Okay, let's add a new issue - please follow these schemes and rules:

Be specific and substantive, a good title is one step towards getting attention.

🔴ALWAYS start your title with the [Product] tag and [System version] tag

🔴For Remix OS for PC hardware related issues, ALWAYS add system architecture tag [32bit] or [64bit], device brand and model.

Examples:

  • [Remix OS for PC][3.0.206][32bit] Asus T100TA - using microphone freezes and breaks the system
  • [Remix OS for PC][3.0.205] Autorotation feature
  • [Remix OS for PC][3.0.205] Apps sorting in the app drawer

Please describe the issue in detail. Be sure to include:

These articles on bug reporting may be useful:

Check next section for examples!

Example:

  • Title: [Remix OS for PC][3.0.205][64bit] Taskbar dissapears on its own

    Comment: Shortly after booting the system up, the taskbar dissapears and doesn't come back. I have the autohide feature disabled. I've attached the logfiles for you. Please help.

  • If related to Remix OS for PC then adding hardware info is MANDATORY (brand and model of the device and the problematic peripheral)
  • Remember to attach the logs. Read Getting log files

Example:

  • Title: [Remix OS for PC][3.0.205][64bit] Brand Model AB123 - Bluetooth doesn't work

Comment: I've tried enabling Bluetooth, but it won't work. I've attached logs for you. Please help.

If it's a feature request, be sure to argument why it should be incorporated into the system.

Example:

  • Title: [Remix OS for PC][3.0.205] Dark theme

Comment: Please add a dark theme to the system - for the notification center, taskbar, start menu, settings etc. Lots of users prefer dark over light/bright, we'd love to get that theme. Thanks


🔴 Currently this section is for [Remix OS for PC] product only and will work for versions 3.0.207 or newer

Logs are text files consisting of errors, hardware and software info - all the information very useful in debugging and troubleshooting. It's essential that you include them in your issues.

Scenarios for log grabbing:

###1. Successful Remix OS boot up

  • Use logtool.sh script in ALT+F1 terminal: (script included with the system)
    • Use ALT+F1 hotkey to open terminal. If it doesn't work, you need to enable debug terminal in Settings -> Experimental Features
    • Enter command: sh /system/bin/logtool.sh
    • All other details will be displayed by the script in terminal output
    • To get back to the Graphical User Interface (GUI) use ALT+F7 hotkey

ALT-F1 logtool script

  • or use logtool.sh script in Termux:(requires root permissions)(script included with the system)
    • Start Termux > select option of choice in Welcome popup
    • Enter command: su
    • Allow Termux root permissions (popup will appear)
    • Enter command: sh /system/bin/logtool.sh
    • All other details will be displayed by the script in Termux output

Termux logtool script

  • Additionally log recorder app - Logcat Extreme - Not preinstalled - Download link.

    This app is perfect for recording errors that occur while performing specific set of actions.

    It saves more definitive, issue oriented data easier to process by the debugger.

    Recording bug occurence with Logcat Extreme app:(requires root permissions)

    • Start Logcat Extreme app > Accept the license
    • Allow root permissions (popup will appear)
    • Click on the circular "+" icon and select Record from the menu
    • Allow storage access
    • Now perform actions that result in a bug or a problem

Logcat Extreme record

If booting process hangs on:

  • Remix OS Logo
  • "_" in top left corner
  • black screen
  • ANDROID root@remix_x86/_x64 # command line

At boot menu, select and run Verbose Mode entry

In some cases you'll need to enter Advanced Options submenu first.

Verbose Mode entry

Log files will be automatically saved in few locations:

  1. Remix OS installation folder/RemixOS_Logs:

    If you installed to C:/RemixOS then logs will be saved to C:/RemixOS/RemixOS_Logs

  2. REMIX_OS:/RemixOS_Logs - Windows friendly USB partition

    If you installed Remix OS to USB/other removable medium using the official Windows installer, then look for folder RemixOS_Logs in partition labeled REMIX_OS.


Which log files do we use?

###The Logtool script saves:

  1. logcat (most useful if recorded using Logcat Extreme)
  2. dmesg
  3. lspci
  4. lsmod
  5. lsusb
  6. cpuinfo

Logs folder

###Verbose Mode saves following logs in folder Automatic:

  1. dmidecode
  2. dmesg
  3. lspci
  4. lsusb
  5. cpuinfo

Also a more seamless and easy way of giving feedback is on the way - stay tuned!