Welcome to SharkGo! This guide will help you get started with the installation and basic usage of SharkGo.

Before you begin, make sure your system meets the following requirements:

• .NET Framework 4.5.1 or newer .NET 6 (the SharkGo setup.exe installer will handle the installation of the prerequisites needed to run on Windows.)
• iTunes (Do not install the Microsoft Store version; choose either 32-bit or 64-bit)
• Visual C++ Redistributable for Visual Studio 2015

• .NET 6.0 Runtime (macOS 10.13 "High Sierra" or newer) - Make sure it's the x64 version, even if you have an M1/M2 Mac

• .NET 6.0 Runtime (only dotnet-runtime-6.0 package is required)

To get started, visit the Releases page and download the latest release.

Once you have downloaded SharkGo, follow these steps to run it on your system:

1. Run the executable called SharkGo.exe.

1. Open the DMG file and drag the application to your Desktop or Applications folder.

2. Double-click to run the app.

1. Open your terminal and navigate to the directory where SharkGo is located.

2. Run the following commands:

   chmod +x ./SharkGo
   ./SharkGo
   
   

Find iDevice:

• Connect your iDevice to your computer. Click the "Find iDevice" button and select your iDevice from the list.

---

Search location/coordinates:

• Enter the desired location (e.g., Sydney, NSW, or coordinates like -33.86984390,151.20828480) in the box and hit "Search" (try to be more specific if you are getting strange results). You can also manually place a pin on the map by double-clicking anywhere.

---

Set Fake Location:

• Click "Set Fake Location". If it is the first time doing this, the tool needs to download some files to enable Developer Mode on your iDevice. Confirm your fake location using Apple Maps, Google Maps, etc.

---

Stop Fake Locatio:

• To stop the fake location, click "Stop Fake Location". If your device is still stuck at the faked location, turn Location Services off and on in Settings > Privacy or You can restarting your iDevice.

(Your device will also have a Developer menu now shown in Settings. You can get rid of it by restarting your iDevice.)

---

Routes:

Select a Location:

• Description: Choose a location from the dropdown menu or click on the map to select a location.
• Selection: [List of available locations or map selection]

Select a Speed:

• Description: Choose a speed from the dropdown menu.
• Selection: [List of available speeds]

Submit:

• Description: Click the "Submit" button after selecting a location (either from the dropdown menu or by clicking on the map) and speed to confirm your choices.

Start Route:

• Description: After submitting your selections, click the "Start Route" button to begin the route at the selected location and speed.

Stop Route:

• Description: To stop the route, click the "Stop Route" button. This will halt the character's movement and return them to the last location they were at before starting the route.

---

Random Walk:

Start a random walk from the selected location, with the speed determined by the user using the lower slider.

---

Moreover, on Windows and MacOS, if you activate Wi-Fi synchronization in iTunes/Finder, your iDevice can be controlled without being connected by cable (requires an initial cable connection to enable Wi-Fi synchronization).

---

In SharkGo Version 2.0.0.3, you can create custom routes to enhance your spoofing experience. Follow these simple steps to create and add custom routes:

1. Plan Your Route on Google Maps:
   • Open Google Maps in your browser.
   • Select "Walking" as the method of transportation.
   • Add waypoints and stops along your desired route.

2. Copy the Route URL:

   • Once you've finished planning your route on Google Maps, copy the URL from your browser's address bar.

3. Convert the Route to GPX:

   • Visit MapsToGPX.com.
   • Paste the copied Google Maps route URL into the provided field.
   • Click the conversion button to generate a GPX file.

4. Save the GPX File:

   • Download the GPX file created by MapsToGPX.com.

5. Add GPX to SharkGo:

   • In your SharkGo installation directory, navigate to the 📁 gpx/route/Custom folder.
   • Place the downloaded GPX file into this folder.

Windows:

6. Ready to Use:
   • Your custom GPX file is now ready to use within SharkGo.

Note: Ensure that you've placed your GPX files in the Custom folder before running SharkGo. When you click the "find idevice" button, the program will locate all GPX files in this folder for your selection.

---

If you encounter any issues while using SharkGo, refer to the following troubleshooting tips:

• Q: My device doesn't show up on the list?

  • A: Ensure that it is plugged in, you have trusted your PC, and that the device is visible on iTunes.

• Q: Help, it says that it can't mount the image or some other generic error?

  • A: Make sure your iDevice is trusted with the PC/Mac, and if everything you've tried is not working, usually a reboot of your device will fix the issue.

• Q: Unable to load shared library 'imobiledevice' or one of its dependencies

  • A: Set the environment variable DYLD_LIBRARY_PATH to the folder which has the libimobiledevice files, and run the project with specified framework and runtime. For example:

    export DYLD_LIBRARY_PATH=$HOME/SharkGo/SharkGo/bin/Debug/net6.0/runtimes/osx-x64/native
    dotnet run --project ./SharkGo/SharkGo.csproj --framework net6.0 --runtime osx-x64

Some users have reported an error when clicking the "Refresh" button within the application. The error they've encountered is as follows:

Unable to load shared library 'imobiledevice' or one of its dependencies. In order to help diagnose loading problems, consider setting the LD_DEBUG environment variable: libimobiledevice: cannot open shared object file: No such file or directory

This issue has been observed on systems running Ubuntu 20.04 with version 1.6 of our application.

We've investigated this problem and have found a solution that might address it on your Ubuntu 20.04 system. Please follow these steps:

1. Download the libimobiledevice.so file from here and place it in a location of your choice on your system. (you only need libssl1.0.0_1.0.2n-1ubuntu<latest version>_<arch>.deb)

2. Open a terminal and navigate to the location where you placed the libimobiledevice.so file.

3. Run the following command to copy the file and rename it:

   cp libimobiledevice.so libimobiledevice

4. Ensure that version libssl1.0.0 is installed on your system. This version isn't available by default on Ubuntu 20.04 onwards. You can download the corresponding deb file from this link. Then, install it using the following command:

   sudo apt install FILE_NAME.deb

Once you've completed these steps, you should be able to click the "Refresh" button without encountering the aforementioned error.

We hope this solution proves helpful. If you continue to experience issues, please feel free to create an issue in our GitHub repository so that we can assist you further.