diff --git a/knowledgebase/bliss-bass/remote_management/images/device-primary_display_2024-03-06_11-44-51.png b/knowledgebase/bliss-bass/remote_management/images/device-primary_display_2024-03-06_11-44-51.png new file mode 100644 index 00000000..72d0c3fb Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/device-primary_display_2024-03-06_11-44-51.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/device-secondary_display_2024-03-06_11-45-39.png b/knowledgebase/bliss-bass/remote_management/images/device-secondary_display_2024-03-06_11-45-39.png new file mode 100644 index 00000000..2898457d Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/device-secondary_display_2024-03-06_11-45-39.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/device_connection-connected_2024-03-06_11-34-02.png b/knowledgebase/bliss-bass/remote_management/images/device_connection-connected_2024-03-06_11-34-02.png new file mode 100644 index 00000000..7ea883cc Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/device_connection-connected_2024-03-06_11-34-02.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/device_connection_2024-03-06_11-33-10.png b/knowledgebase/bliss-bass/remote_management/images/device_connection_2024-03-06_11-33-10.png new file mode 100644 index 00000000..43b15794 Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/device_connection_2024-03-06_11-33-10.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/init_mapping_2024-03-06_11-37-56.png b/knowledgebase/bliss-bass/remote_management/images/init_mapping_2024-03-06_11-37-56.png new file mode 100644 index 00000000..5dd8e918 Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/init_mapping_2024-03-06_11-37-56.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/main-keep_display_off_2024-03-06_11-34-41.png b/knowledgebase/bliss-bass/remote_management/images/main-keep_display_off_2024-03-06_11-34-41.png new file mode 100644 index 00000000..e5998add Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/main-keep_display_off_2024-03-06_11-34-41.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/mapping_2024-03-06_11-37-25.png b/knowledgebase/bliss-bass/remote_management/images/mapping_2024-03-06_11-37-25.png new file mode 100644 index 00000000..e76651fe Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/mapping_2024-03-06_11-37-25.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/mapping_screen_2024-03-06_11-38-29.png b/knowledgebase/bliss-bass/remote_management/images/mapping_screen_2024-03-06_11-38-29.png new file mode 100644 index 00000000..58a95edf Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/mapping_screen_2024-03-06_11-38-29.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/permissions_2024-03-06_12-07-50.png b/knowledgebase/bliss-bass/remote_management/images/permissions_2024-03-06_12-07-50.png new file mode 100644 index 00000000..d107cea4 Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/permissions_2024-03-06_12-07-50.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/primary_display_2024-03-06_11-32-32.png b/knowledgebase/bliss-bass/remote_management/images/primary_display_2024-03-06_11-32-32.png new file mode 100644 index 00000000..5ead8ff3 Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/primary_display_2024-03-06_11-32-32.png differ diff --git a/knowledgebase/bliss-bass/remote_management/images/second_display_2024-02-28_20-57-16.png b/knowledgebase/bliss-bass/remote_management/images/second_display_2024-02-28_20-57-16.png new file mode 100644 index 00000000..0a792e2d Binary files /dev/null and b/knowledgebase/bliss-bass/remote_management/images/second_display_2024-02-28_20-57-16.png differ diff --git a/knowledgebase/bliss-bass/remote_management/using_scrcpy_for_remote_management.md b/knowledgebase/bliss-bass/remote_management/using_scrcpy_for_remote_management.md new file mode 100644 index 00000000..ee375701 --- /dev/null +++ b/knowledgebase/bliss-bass/remote_management/using_scrcpy_for_remote_management.md @@ -0,0 +1,58 @@ +# Using Scrcpy For Remote Management + +scrcpy is a popular open-source tool that allows remote access and control of your Android device using adb interface. + +It comes in a number of forms: + +**scrcpy:** +- https://github.com/Genymobile/scrcpy + +**guiscrcpy:** +- https://github.com/srevinsaju/guiscrcpy + +**qtscrcpy:** +- https://github.com/barry-ran/QtScrcpy + +## Installing guiscrcpy: + +This guide will run through using the guiscrcpy tool. We will start off by navigating to the latest [releases](https://github.com/srevinsaju/guiscrcpy/releases/tag/v2023.1.1) page and downloading the "guiscrcpy-vXXXX.X.X.dev.r.glibcX.X-x86_64.AppImage" file as it contains all the required dependencies to run on most setups. + +Once downloaded, you will want to set executable permissions for the AppImage file by right-clicking, selecting Properties, and checking the box next to **Allow this file to run as an executable**, then you can close the dialog. + +![permissions](images/permissions_2024-03-06_12-07-50.png) + +## Main Program: + +Launching the AppImage will load to display the main GUI: +![main GUI](images/main-keep_display_off_2024-03-06_11-34-41.png) + +### Connecting to a device: + +To connect to a new device, start by clicking on the **wireless icon** under the options panel. From there, you can hit the **refresh** button to display any devices broadcasting ADB on the network, or you can type in the IP directly and tap the **Connect** button to connect to that device. +![device connection](images/device_connection_2024-03-06_11-33-10.png) +Once a device is connected, it will show the status in the grey textbox like below: +![device connected](images/device_connection-connected_2024-03-06_11-34-02.png) +From here, we can close the window and continue to the next steps. + +### Remote operation of the device + +Once we are connected, you can select the **Start Scrcpy** button to remote into the device + +![remote display - primary screen](images/device-primary_display_2024-03-06_11-44-51.png) + +You can use your mouse and keyboard to operate the device, or you can use the button tools provided by guiscrcpy (moving those out of the main interaction area first). + +#### Connecting to secondary display: + +In order to remote into the connected displays on the device, this requires us to use the "additional flags" preferences from within guiscrcpy, adding `--display #` where `#` is the display ID for your target display. + +Example: +![second-display specification](images/second_display_2024-02-28_20-57-16.png) + +After adding `--display 2`, we can click the **Start Scrcpy** button and it will remote into the secondary display connected to the device. +![remote display - display ID 2](images/device-secondary_display_2024-03-06_11-45-39.png) + +## Other Options: + +You can configure the options further by using the "additional flags" textbox. A good reference for the possibilities is the [official scrcpy documentation](https://github.com/Genymobile/scrcpy?tab=readme-ov-file#user-documentation). +