| Usage |
python g-code_ripper-XXX.py [-g file ] or g-code_ripper-XXX.py [-g file ] |
|
-c (or --config_file) |
Configuration file to read |
|
-g (or --gcode_file) |
g-code file to read |
|
-d (or --defdir) |
Default open/save directory |
|
-h (or --help) |
print syntax help to console window. |
|
Example (Using python script with preinstalled python distribution) |
python g-code_ripper-XXX.py -g my_file.ngc |
|
Example (Using precompiled Windows executable) |
g-code_ripper-XXX.exe -g my_file.ngc |
| F1 | Open the Help dialog box. (There is nothing in the help except a reference back to the web page and my e-mail address) |
| F2 | Opens General Settings Window |
| F5 | Refresh display |
|
g-code-ripper_config.ngc or .gcoderipperrc |
When G-Code Ripper starts up the directory in which G-Code Ripper starts in is searched for a file named "g-code-ripper_config.ngc". If the file is found it is read and all of the G-Code Ripper options are set according to the settings saved in the config file. After searching for the config file in the current directory the users home directory is searched for "g-code-ripper_config.ngc" or ".gcoderipperrc" if either of these are found it will be used as the default settings. Only the first config file found is read. To create a config file with your preferred options for startup just open G-Code Ripper and change the settings to your liking and click the save button next to configuration file in the settings window. |
| G-Code Base Operations: | This section contains basic operations that are performed prior to any G-Code Operations selected below. The base operations are always applied before the additional operations. |
| Scale XY | Sets the scaling percentage for X and Y axes to be applied to the input g-code file. |
| Scale Z | Sets the scaling percentage for Z axis to be applied to the input g-code file. |
| Scale Feed | Sets the scaling percentage for feed rate to be applied to the input g-code file. |
| Rotate | Sets the angle in degrees to rotate input g-code file. |
| Origin | The origin determines the relative location of the g-code x and y zero location. The current location of the origin is displayed in the display window as a red and green lines. The red and green lines follow the RGB convention Red is the x-axis, Green in the y-axis. |
| Save G-Code File Base (Button) | This button results in saving the g-code with only the option above the button being applied (scale, rotate, origin). Any further options from below or on the right side of the image are not applied. |
| View Plane: | This section contains a variety of view plane orientations only one of the options is active at any time. |
| G-Code Operations: | In this section the additional operations that can be applied to the g-code can be selected. |
| None | No operations are performed in addition to the base operations. |
| Split | The G-Code is split along a line creating two g-code programs that can be run independently. |
| Wrap | One of the G-Code linear axes (X or Y) is mapped to a rotary axis (A or B) for machining on a cylinder. |
| Input Field | Description |
| Split X Position | X position of the splitting line. (i.e. the line on which the g-code is divided into two parts.) The X position is measured from the origin set in the base operations section. |
| Split Y Position | Y position of the splitting line. (i.e. the line on which the g-code is divided into two parts.) The Y position is measured from the origin set in the base operations section. |
| Split Angle | The angle of the splitting line. |
| Rotate Black | The rotate black setting determines whether one of the two sides of the split will be rotated by 180 degrees. Rotating 180 degrees allows the stock to be rotated 180 degrees in the machine to machine the second half. Doing this process can effectively increase size of designs that can be cut by a given machine. |
| Save G-Code File-Black (Button) | This button saves the g-code displayed as black in the canvas. |
| Save G-Code File-White (Button) | This button saves the g-code displayed as white in the canvas. |
| Plunge Feed | Because the g-code is being split additional cut starts and stops are required. During the additional starts the tool needs to plunge into the stock material. The plunge feed sets the feed rate for these new moves into the stock material. |
| Z Safe | Because the g-code is being split additional cut starts and stops are required. After one of the additional cut stops the tool needs to move to a safe position for rapid movement. The Z Safe setting sets the z position of this z location that is safe for rapid motions. |
After "Ancient Echoes," the developers have planned features like a character creator, dynamic traits, random encounters, and new enemy factions. However, the main story quest is slated to be the final addition before the game leaves Early Access.
: Venture into procedurally generated dungeons, each filled with treasures, traps, and monsters. The layout of the dungeon, the enemies you encounter, and the loot you find are all randomized, providing a fresh experience with each playthrough.
: Create a folder named Stoneshard in your Android device's internal storage. Connect your phone to your PC and copy the entire contents of your PC's Stoneshard installation folder (containing StoneShard.exe ) directly into that new mobile folder.
: A mid-to-high-range Android phone or tablet, a copy of Stoneshard on your PC (from Steam or another digital store), and the free open-source emulator GameHub Lite.
Now, the part you’ve been waiting for. As of 2026, there is . The game remains in active development for PC, and its complex systems have made a mobile port a lower priority for the small development team. Back in 2018, when first questioned about it, the developer confirmed that even if they had plans, a port was "most likely... a couple of years" away.
You will love Stoneshard on Android if:
Fortunately, dedicated players have discovered reliable workarounds to enjoy the brutal mercenary experience on mobile devices. How to Play Stoneshard on Android Right Now
However, prospective players must go in with realistic expectations. The save system is a major hurdle for short play sessions, the touch controls require some adjustment, and there is no official support if something goes wrong. The developers have made it clear their focus is the PC version, and an official Android port is not on the immediate horizon.
Porting a complex PC CRPG to a touchscreen is a nightmare. Stoneshard’s solution is a virtual joystick for movement and a robust radial menu for abilities.
: This is the most stable method. You run the game on your PC and stream it to your Android device via the StarDesk app .
While the game seems ideal for touchscreens due to its turn-based, grid-focused mechanics, porting the complex inventory system, skill management, and UI requires significant development time—resources the team is currently focusing on content updates like the "Blood Omens" update expected in 2026.
mobile is defined by technical ingenuity and a patient, albeit hopeful, community. The Official Stance and Development Realities
The Unending Road: The Prospects of Stoneshard on Android The digital landscape of mobile gaming is often criticized for its saturation with casual, microtransaction-heavy titles. In this context, the desire for a complex, unforgiving experience like Stoneshard

| Input Field | Description |
| Include Rapid Moves | If selected the rapid moves will be included in the exported output. |
| File Type | Select the type of file to be exported |

| Input Field | Description |
| Probe X Offset |
X distance from the tool to the probe. (if the tool is the probe this should be set to zero) |
| Probe Y Offset |
Y distance from the tool to the probe. (if the tool is the probe this should be set to zero) |
| Probe Z Offset |
Z distance from the tool to the probe. (if the tool is the probe this should be set to zero) (It is best to keep this value as close to zero as possible to prevent crashing the tool or probe) |
| Probe Z Safe |
This is the safe Z height when probing (When the probe is over the work piece). Be aware of where the tool will be when the probe is at this position to avoid cashing the tool. |
| Probe Depth |
Max Depth the probe will travel attempting to detect the work piece. If the probe travels to this position and does not detect the part an error will occur. |
| Probe Feed | The feed rate for the probe when it is lowering to detect the part. |
| X Points |
This is the number of points that form the grid of probe points in the X direction. Points that are not needed (too far from tool path) are displayed as black in the preview canvas and will not probed. |
| Y Points |
This is the number of points that form the grid of probe points in the Y direction. Points that are not needed (too far from tool path) are displayed as black in the preview canvas and will not probed. |
| Post Probe |
This is a text entry field for any G-Codes that should be executed prior to the pause between probing and cutting. (If you want to swap the probe head for the tool head you may want to raise to a specified Z height (i.e. G0Z5.0) |
| Controller | Set the CNC controller to be used. LinuxCNC and MACH3 are supported. They require different codes for probing etc. |
After "Ancient Echoes," the developers have planned features like a character creator, dynamic traits, random encounters, and new enemy factions. However, the main story quest is slated to be the final addition before the game leaves Early Access.
: Venture into procedurally generated dungeons, each filled with treasures, traps, and monsters. The layout of the dungeon, the enemies you encounter, and the loot you find are all randomized, providing a fresh experience with each playthrough.
: Create a folder named Stoneshard in your Android device's internal storage. Connect your phone to your PC and copy the entire contents of your PC's Stoneshard installation folder (containing StoneShard.exe ) directly into that new mobile folder.
: A mid-to-high-range Android phone or tablet, a copy of Stoneshard on your PC (from Steam or another digital store), and the free open-source emulator GameHub Lite.
Now, the part you’ve been waiting for. As of 2026, there is . The game remains in active development for PC, and its complex systems have made a mobile port a lower priority for the small development team. Back in 2018, when first questioned about it, the developer confirmed that even if they had plans, a port was "most likely... a couple of years" away.
You will love Stoneshard on Android if:
Fortunately, dedicated players have discovered reliable workarounds to enjoy the brutal mercenary experience on mobile devices. How to Play Stoneshard on Android Right Now
However, prospective players must go in with realistic expectations. The save system is a major hurdle for short play sessions, the touch controls require some adjustment, and there is no official support if something goes wrong. The developers have made it clear their focus is the PC version, and an official Android port is not on the immediate horizon.
Porting a complex PC CRPG to a touchscreen is a nightmare. Stoneshard’s solution is a virtual joystick for movement and a robust radial menu for abilities.
: This is the most stable method. You run the game on your PC and stream it to your Android device via the StarDesk app .
While the game seems ideal for touchscreens due to its turn-based, grid-focused mechanics, porting the complex inventory system, skill management, and UI requires significant development time—resources the team is currently focusing on content updates like the "Blood Omens" update expected in 2026.
mobile is defined by technical ingenuity and a patient, albeit hopeful, community. The Official Stance and Development Realities
The Unending Road: The Prospects of Stoneshard on Android The digital landscape of mobile gaming is often criticized for its saturation with casual, microtransaction-heavy titles. In this context, the desire for a complex, unforgiving experience like Stoneshard