Update README.md

This commit is contained in:
Narsty
2023-07-09 23:56:08 -05:00
committed by GitHub
parent 460f8df5b3
commit 780a86bd64
+55 -87
View File
@@ -23,112 +23,80 @@
<img src="https://media.giphy.com/media/tR8stUDuzhgAHrr2i8/giphy-downsized-large.gif" alt="Giphy Image" style="width: 300px; height: auto;">
</div>
<div align="center">
# 🔹 They are Plug & Play 🔹
<h1 align="center"><u> 🔹They are Plug & Play🔹 </u></h1>
</div>
<h2 align="center"><u>Big shoutout and huge thanks to <a href="https://github.com/grugnoymeme">47LeCoste</a> <a href="https://github.com/ClaraCrazy">ClaraCrazy</a> <a href="https://github.com/0iphor13">0iphor13</a> <a href="https://github.com/hak5">Hak5</a> <a href="https://github.com/I-Am-Jakoby">I-Am-Jakoby</a> and <a href="https://github.com/UberGuidoZ">UberGuidoZ</a></u></h2>
## Acknowledgements
<h2 align="center">Check Out the Xremote (Cross Remote) by <a href="https://github.com/leedave">leedave</a> to Chain Infared and SubGHz Together! 📱
A big shoutout and huge thanks to these amazing contributors:
- [47LeCoste](https://github.com/grugnoymeme)
- [ClaraCrazy](https://github.com/ClaraCrazy)
- [0iphor13](https://github.com/0iphor13)
- [Hak5](https://github.com/hak5)
- [I-Am-Jakoby](https://github.com/I-Am-Jakoby)
- [UberGuidoZ](https://github.com/UberGuidoZ)
## Xremote (Cross Remote)
Check out the Xremote project by [leedave](https://github.com/leedave) to chain Infrared and SubGHz together! 📱
- [XRemote (BETA)](https://github.com/leedave/Leeds-Flipper-Zero-Fap-Files/tree/main/Xtreme)
<p>
<a href="https://github.com/leedave/Leeds-Flipper-Zero-Fap-Files/tree/main/Xtreme" style="font-size: 18px;">XRemote<a>(BETA)<h2>
## MacOs Flipper Zero Collection
<p align="center">
<a href="https://github.com/narstybits/MacOS-DuckyScripts">
<img src="https://img.shields.io/badge/-MacOs%20Flipper%20Zero%20Collection-brightgreen">
</a>
<a
href="https://github.com/narstybits/MacOS-DuckyScripts/blob/main/Goodusb/Git%20Repository%20Updater.txt">
<img src="https://img.shields.io/badge/-NEWEST%20FLIPPER%20Zero%20SCRIPT-blue">
</a>
</div>
<h2 align="center"> If you're a visual learner like me, check out this detailed tutorial: <a href="https://github.com/wrenchathome/flipperfiles/blob/main/_Guides/How2Flipper.pdf" style="text-decoration: none;">How 2 Flipper Guide
- [![MacOs Flipper Zero Collection](https://img.shields.io/badge/-MacOs%20Flipper%20Zero%20Collection-brightgreen)](https://github.com/narstybits/MacOS-DuckyScripts)
- [![NEWEST FLIPPER Zero SCRIPT](https://img.shields.io/badge/-NEWEST%20FLIPPER%20Zero%20SCRIPT-blue)](https://github.com/narstybits/MacOS-DuckyScripts/blob/main/Goodusb/Git%20Repository%20Updater.txt)
## How 2 Flipper Guide
If you're a visual learner like me, check out this detailed tutorial by [wrenchathome](https://github.com/wrenchathome):
<p align="center">Thanks to <u><a href="https://github.com/wrenchathome">wrenchathome</a></u></h2>
<ol>
- [How 2 Flipper Guide](https://github.com/wrenchathome/flipperfiles/blob/main/_Guides/How2Flipper.pdf)
<h1
align="center"><p>Step by Step Directions to get you up and running will be posted Below! <p>
<div align="center">
<div align="center">
<h1>🔹 Step by Step Directions to Get You Up and Running 🔹</h1>
<img alt="Coding" width="450" height="15" src="https://media.giphy.com/media/9JxkPTP3alOykb8PmQ/giphy.gif">
</div>
<h3
<div style="border: 2px solid #000000; padding: 10px;">
<p style="font-size: 32px; margin: 0;">
<p>
<span style="font-size: 0;"></span>🔹 First, always read the Remarks. You will see "REM," which is used to explain the purpose of each line or provide instructions to the user. It's very important to always READ the REMs!
</p>
<p>
<span style="font-size: 0;"></span>🔹 Here are a few strings you will normally see in my scripts as well as their function/purpose:
</p>
<h4>
The VendorID and ProductID combination helps the operating system identify the specific device (in this case the FLipper Zero) and load the appropriate drivers or configurations I.E. (Apple keyboard).
</p>
<pre>
<code>
'ID 05ac:021e Apple:Keyboard'
</code>
</pre>
<p>
This code enables the `ignorespace` option for the command history, preventing commands with a leading space from being stored in the shell history.
Big shoutout to <a href="https://github.com/FalsePhilosopher">FalsePhilosopher</a> for helping me create this string!
</p>
<pre>
<code>
'echo -e "export HISTCONTROL=ignorespace\nunset HISTFILE" >> ~/.bashrc && source ~/.bashrc && exec bash </code>
</pre>
This string removes the specific command from the history, ensuring minimal traces are left behind. This helps maintain discretion and privacy.
<pre>
<code>
history -d $(history | tail -n 2 | head -n 1 | awk '{ print $1 }')' </code>
</pre>
<h1
align="center"
<span style="font-size: 0;"></span>🔹 Step by Step Directions <p>
<div style="border: 2px solid #000000; padding: 10px;">
<h3 style="font-size: 32px; margin: 0;">🔹 First, Always Read the Remarks</h3>
<p>When working with the scripts, make sure to carefully read the REM (remark) lines. REMs explain the purpose of each line or provide instructions to the user. It's crucial to always read and understand the REMs!</p>
</div><h3
<span style="font-size: 0;"></span>1. To upload the .txt files to your Flipper, you will need to Download(Easiest method) or copy and paste the raw code into the MacOs application "TextEdit" or whichever program you prefer (TextEdit is also easy).</p>
<div align="left">
<img alt="Coding" width="1473" height="5" src="https://media.giphy.com/media/RH27Uw1IFGfIs/giphy.gif">
<h4>The VendorID and ProductID Combination</h4>
<pre><code>'ID 05ac:021e Apple:Keyboard'</code></pre>
<p>This code helps the operating system identify the specific device (in this case, the Flipper Zero) and load the appropriate drivers or configurations, such as for an Apple keyboard.</p>
<h4>The 'ignorespace' Option</h4>
<pre><code>'echo -e "export HISTCONTROL=ignorespace\nunset HISTFILE" >> ~/.bashrc && source ~/.bashrc && exec bash'</code></pre>
<p>This code enables the 'ignorespace' option for the command history, preventing commands with a leading space from being stored in the shell history. Special thanks to [FalsePhilosopher](https://github.com/FalsePhilosopher) for helping create this string!</p>
<h4>Removing Specific Commands from History</h4>
<pre><code>history -d $(history | tail -n 2 | head -n 1 | awk '{ print $1 }')</code></pre>
<p>This code removes the specific command from the history, ensuring minimal traces are left behind and helping maintain discretion and privacy.</p>
</div>
<p style="font-size: 12px; margin: 0;">2. (If you Downloaded the .txt you can skip these next two steps) Once you've copied and pasted the code into your preferred program, you will need to export or save the file to your desktop as a .txt file!</p>
<div align="left">
<img alt="Coding" width="1473" height="5" src="https://media.giphy.com/media/RH27Uw1IFGfIs/giphy.gif">
</div>
<p style="font-size: 12px; margin: 0;">3. You can type .txt after the file name, and it will prompt you to save the file as a .txt.</p>
<div align="left">
<img alt="Coding" width="1473" height="5" src="https://media.giphy.com/media/RH27Uw1IFGfIs/giphy.gif">
</div>
<p style="font-size: 12px; margin: 0;">4. Now, you can plug the flipper in and open up the File Manager, navigate to the SD card, and open up the BADUSB file within the SD card.</p>
<div align="left">
<img alt="Coding" width="1473" height="5" src="https://media.giphy.com/media/RH27Uw1IFGfIs/giphy.gif">
</div>
<p style="font-size: 12px; margin: 0;">5. This is where you can drag and drop your .txt files, and once you are done, close out of the Flipper desktop app.</p>
<div align="left">
<img alt="Coding" width="1473" height="5" src="https://media.giphy.com/media/RH27Uw1IFGfIs/giphy.gif">
</div>
<p style="font-size: 12px; margin: 0;">6. You are now ready to deploy your BADUSB DuckyScripts and take over the World! ENJOY :)</p>
</div>
<p> </p>
<p> </p> <p> </p>
<p> </p>
<h1 align="center">🔹 Step by Step Directions 🔹</h1>
<ol>
<li>
<p>To upload the .txt files to your Flipper, you have two options:</p>
<ul>
<li>If you downloaded the .txt files, proceed to step 2.</li>
<li>If you copied and pasted the code into a program, export or save the file as a .txt file on your desktop.</li>
</ul>
</li>
<li>
<p>Plug the Flipper into your computer and open the File Manager.</p>
<p>Navigate to the SD card and open the BADUSB folder.</p>
<p>Drag and drop the .txt files into the BADUSB folder.</p>
<p>Close the Flipper desktop app when finished.</p>
</li>
<li>You are now ready to deploy your BADUSB DuckyScripts and take over the world! Enjoy!</li>
</ol>
<h1
align="center">Support Narsty!