Merge branch 'main' into main

Author: OBITORASU

.github/CONTRIBUTING.md

@@ -7,7 +7,7 @@ This document will give you a detailed overview over how to contribut
 
 ## New contributors guide
 
-See the [README](README.md) to get an overview of the project and find other necessary information. Here are some great resources to get you comfortable with open source contributions:
+See the [README](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/blob/main/README.md) to get an overview of the project and find other necessary information. Here are some great resources to get you comfortable with open source contributions:
 - [Finding ways to contribute to open source on GitHub](https://docs.github.com/en/get-started/exploring-projects-on-github/finding-ways-to-contribute-to-open-source-on-github)
 - [Set up Git](https://docs.github.com/en/get-started/quickstart/set-up-git)
 - [GitHub flow](https://docs.github.com/en/get-started/quickstart/github-flow)

README.md

@@ -17,7 +17,7 @@ You can open an issue with us for a bug, feature or a new script or start workin
 
 ## Things to keep in mind when contributing
 
-If you are adding a script to the respository, please create a seperate directory with the name of the script inside the `scripts` directory of this repository and work within it. Make sure your script comes with its very own `README.md` with proper documentation for the end user, if possible add screenshots of your script working in the `README.md` as well. In case you are uploading screenshots and/or other relevant images please create a seperate `images` folder inside your script folder, this is where you will be keeping your images. Alternatively, you can also upload your images on platforms like [imgur](https://imgur.com/) and use the resulting link in your `README.md` file.
+If you are adding a script to the repository, please create a separate directory with the name of the script inside the `scripts` directory of this repository and work within it. Make sure your script comes with its very own `README.md` with proper documentation for the end user, if possible add screenshots of your script working in the `README.md` as well. In case you are uploading screenshots and/or other relevant images please create a separate `images` folder inside your script folder, this is where you will be keeping your images. Alternatively, you can also upload your images on platforms like [imgur](https://imgur.com/) and use the resulting link in your `README.md` file.
 
 Once you are done working on your script edit this `README.md` file and add the relevant information regarding your script in the table below.
 
@@ -56,7 +56,7 @@ Once you are done working on your script edit this `README.md` file and add the
 29| Reddit Image Scrapper | Downloads Reddit Images according to given SubReddit without using API | [Find me here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/Reddit-Image-Scrapper) |
 30| SMS Sender | Easy CLI interface for users looking to test their SMS campaign integration with Kaleyra | [Find me here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/SMS%20Sender) |
 31| Shorty | Shorty uses python code to shorten URLs on the go | [Find me here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/Shorty) |
-32| Sketch image converter | script which convert a colored photo into sketch photo | [Find me here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/image_converter) |
+32| Image to Sketch Converter | Script which converts a colored photo into pencil sketch or cartoonized sketch | [Find me here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/image_to_sketch_converter) |
 33| Song-Lyrics-Fetcher | Fetch lyrics of a song and store in a text file | [Find me here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/Song-Lyrics-Fetcher) |
 34| Spectrogram | script to visualize wav files using spectrogram | [Find me here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/spectrogram) |
 35| Terminal Video Editor | Edit Small Videos (less than : 10 mins) directly from your Terminal | [Find me here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/Terminal-Video-Editor) |
@@ -100,5 +100,6 @@ Once you are done working on your script edit this `README.md` file and add the
 73| PDF-Delete-Pages | Deletes pages from PDF as entered by the user | [Find me Here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/PDF-Delete-Pages)   |
 74| Copy to clipboard | Copies contents form a text file to your clipboard | [Find me Here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/Copy%20to%20clipboard)   |
 75| Video-to-audio Convertor    | Extracts audios from videos. | [Find me here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/Video-to-audio-convertor) |
+76| Audio Recorder | Records audio from system's audio input device for `n` seconds | [Find me Here](https://github.com/GDSC-RCCIIT/General-Purpose-Scripts/tree/main/scripts/Audio%20Recorder)   |
 
 ### Good Luck and don't forget to have fun with Open Source 🚀

scripts/Audio Recorder/README.md

@@ -0,0 +1,17 @@
+## How to run
+1. Clone the repository
+   ```
+   git clone [email protected]:GDSC-RCCIIT/General-Purpose-Scripts.git
+   ```
+2. Install the script requirements
+   ```
+   pip install -r requirements.txt
+   ```
+3. Navigate to `Audio Recorder` directory
+   ```
+   cd General-Purpose-Scripts/scripts/Audio Recorder
+   ```
+4. Run the script to record audio
+   ```
+   python audio.py
+   ```

scripts/Audio Recorder/audio.py

@@ -0,0 +1,29 @@
+import time
+import sounddevice as sd
+import wavio as wv
+
+# Sampling frequency
+freq = 45000
+
+# Recording duration
+duration = int(input("Enter the duration (in seconds): "))
+
+print("Recording...")
+# Start recorder with the given values of duration and sample frequency
+recording = sd.rec(int(duration * freq), samplerate=freq, channels=2)
+
+# View timer and record audio for the given number of seconds
+while duration:
+    mins, secs = divmod(duration, 60)
+    timer = "{:02d}:{:02d}".format(mins, secs)
+    print(timer, end="\r")
+    time.sleep(1)
+    duration -= 1
+
+print("Done!")
+num = input("Enter a number for your file name: ")
+
+# Convert the NumPy array to audio file
+wv.write("recording" + num + ".wav", recording, freq, sampwidth=2)
+
+print("Saved file as recording" + num + ".wav in the present directory.")

scripts/Audio Recorder/requirements.txt

@@ -0,0 +1,2 @@
+sounddevice==0.4.3
+wavio==0.0.4

scripts/Copy to clipboard/README.md

@@ -0,0 +1,21 @@
+## How to run
+
+1. Clone the repository
+   ```
+   git clone [email protected]:GDSC-RCCIIT/General-Purpose-Scripts.git
+   ```
+2. Install the script requirements
+   ```
+   pip install -r requirements.txt
+   ```
+3. Navigate to `Copy to clipboard` directory
+   ```
+   cd General-Purpose-Scripts/scripts/Copy to clipboard
+   ```
+4. Run the script to copy text from the desired file to your clipboard
+   ```
+   python clipboard.py <file_name>
+   ```
+   ### Note
+   Replace <file_name> with the name of the file present in the same directory as the script or replace it with the path of the file.
+   For Linux users, install [xclip](https://linoxide.com/copy-paste-commands-output-xclip-linux/) in your system before running the script.

scripts/Copy to clipboard/clipboard.py

@@ -0,0 +1,30 @@
+import os
+import sys
+import platform
+import subprocess
+import pyperclip
+
+# Seeing if the file exists
+if os.path.exists(sys.argv[1]):
+    f = open(sys.argv[1], "r")
+    f_contents = f.read()
+    f.close()
+else:
+    print(
+        "Usage: python clipboard.py file_name\n      OR\n       python clipboard.py 'path_of_the_file'"
+    )
+    exit(1)
+
+whatos = platform.system()
+
+if whatos == "Darwin":
+    subprocess.run("pbcopy", universal_newlines=True, input=f_contents)
+    print("Success! Copied to clipboard.")
+elif whatos == "Linux":
+    pyperclip.copy(f_contents)
+    print("Success! Copied to clipboard.")
+elif whatos == "Windows":
+    subprocess.run("clip", universal_newlines=True, input=f_contents)
+    print("Success! Copied to clipboard.")
+else:
+    print("Failed! Clipboard not supported.")

scripts/Copy to clipboard/requirements.txt

@@ -0,0 +1 @@
+pyperclip==1.8.2

scripts/Instagram Photo Downloader/Readme.md

@@ -5,6 +5,6 @@
 3. Install chromedriver simply from the `chromedriver.exe` file.
 4. Change your working directory to the directory of this script using: `cd General-Purpose-Scripts/scripts/Instagram Photo Downloader`.
 5. Install the dependencies using `pip install -r requirements.txt`.
-6. Run the typing_speed_test.py file in terminal with `python3 insta_pic_downloader.py`.
+6. Run the insta_pic_downloader.py file in terminal with `python3 insta_pic_downloader.py`.
 7. Enter the URL of the photo you want to download and press Enter.
 8. The photo will be downloaded in the same directory as `insta_pic_downloader.py`.

scripts/Mood Sentiment Analyzer/README.md

@@ -0,0 +1,30 @@
+# Mood Sentiment Analyzer
+
+![built by developers](http://ForTheBadge.com/images/badges/built-by-developers.svg)
+![python](https://img.shields.io/badge/language-Python-orange?style=for-the-badge)
+
+## Setup and activate virtual environment
+
+```python
+Video on how to activate virtual environment:
+For Windows: https://youtu.be/APOPm01BVrk
+For Unix: https://youtu.be/Kg1Yvry_Ydk
+```
+
+Analyzes and evaluate the general mood of a given paragraph from a text file:
+
+- (Either Positive, Negative or Neutral.)
+- Provide sentiment polarity percentage of the expressed sentiment. 
+- Evaluate each sentences 'mood'
+
+## Steps to utilize script
+
+1. Create your text file.
+2. open `app.py` and replace file name with your create file.
+3. `python app.py`
+4. View result on `ms-analyzer.log`
+
+_**Installing**_
+
+- [x] Requires Python3.
+- [x] Requests modules. You can check out the versions in `requirements.txt` file.