Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SerjSX/pSearch
Searching tool written in Python for Piracy related websites.
https://github.com/SerjSX/pSearch
python python3 search searching
Last synced: about 2 months ago
JSON representation
Searching tool written in Python for Piracy related websites.
- Host: GitHub
- URL: https://github.com/SerjSX/pSearch
- Owner: SerjSX
- License: gpl-3.0
- Created: 2022-08-13T11:03:41.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2023-08-09T13:05:56.000Z (11 months ago)
- Last Synced: 2024-02-05T09:16:00.668Z (5 months ago)
- Topics: python, python3, search, searching
- Language: Python
- Homepage: https://serjsx.github.io/wpSearch/
- Size: 6.57 MB
- Stars: 26
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Lists
- project-awesome - SerjSX/pSearch - Searching tool written in Python for Piracy related websites. (Python)
README
# pSearch
Searching tool written in Python for Piracy related websites. You choose where you want to search, and the program does its own work and shows you the results. It is similar to normal search engines, however the program searches the site on-spot rather than having a database with different results.
~ If you see a terminal/command line opening when you run the program, don't worry about it! It's for showing errors, that way you and I can see the error easily (if there is one).
## Three launching methods
|*Title*|**Source Code**|**Windows Standalone**|**Windows Onefile Standalone**|
|:-|:-|:-|:-|
|**Descripton**|Running pSearch from the source code requires BeautifulSoup and CustomTkinter. This is the fastest way you can run the program (if familiar with Python), as it isn't built in any way and it's just it.|This is a standalone build of the program meant for distribution in .exe form. The program is built with Nuitka. You may face errors, if you do so please let me know about them.|This is similar to the Windows Standalone method, but you won't see the other modules in the folder as they are embedded in the .exe file (that's why it's Onefile). There are two folders, "others" and "media", and two zip files, "bs4" and "customtkinter", in the package so the program would run in a correct way. The program unzips the zip files for module usage. Launching the program may take a long time with this method.|
|**Health**|*Runs Fast*|*Runs Fast*|*Runs Slow*|
|**Button Name on Site**|View Latest Release GitHub|Download Latest .EXE for Windows|Download Latest .EXE Onefile for Windows|
***Source Code and Onefile seem to be efficient enough, because both extract customtkinter and bs4.zip. If you face errors let me know immediately about it. Version 1.6.4 will have console enabled, that way you can see the error from the command line and send it to me here or on Github Issues.***
## Using the program
||**Description**|
|:-|:-|
|**Using site input box -** ***choosing where to search, has a smaller input in size in the program with the text "Enter site name here"***|You can either \[1\] type a site's name, the program checks if the site is in the database and proceeds with the search, \[2\] choose a site from the dropdown options shown by clicking the upside down arrow next to the site input box, \[3\] click one of the Types buttons or choose one of the Collections|
|**Using search input box -** ***typing what you want to search in the chosen site(s)***|You can type anything you want in the input box, and then you can either \[1\] click the search button, or \[2\] click the Enter button from your keyboard, in order to start searching|
|**Browsing the results page**|\[1\] You can click on the title / link of the result to visit the site, \[2\] you can click on the site's name to visit the normal homepage of the site, \[3\] if the results count is greater than 50 you can browse other pages by clicking the number buttons at the bottom of the page|
## Requirements and Running
This software uses BeautifulSoup and CustomTkinter. Use this command within the extracted folder to install everything from the requirements.txt file, or you can manually from PyPI:
pip install -r requirements.txt
Make sure you have pip and Python installed.
Keep in mind, running it with native Python will always be faster than with a UI/web version, once you install Python and the requirements it's easy and fast to run it.
Open terminal in the program's folder (from Linux point) and run
python3 pSearch.py
But as an alternative and a faster method, I also build the program in a standalone executable file which you can download from every release.
## There are some not-so-important functionalities at the top...
- **DB Checker** checks the health (page code) of all of the sites in the database then prints it in the command line. Make sure to run the .exe via command line to see the actual results because I have disabled the console while building the program.
- **Base64 Encode/Decode** is for decoding/encoding base64. I added this because FMHY has a base64 database so you can directly use this to decode them (that's the main reason I added it for but of course it can be used for its primary functionality).
## Notice
- This tool doesn't let you download files. Simply just a search tool. It doesn't grab direct download links, it just searches and gives you the original pages of the website.
- You may face errors when using the standalone version for Windows. If you do face any errors please report it in the Issues section so I would know, or in the Reddit post: https://www.reddit.com/r/Piracy/comments/zz9tn7/psearch_piracy_multisearching_tool/
### Violation Notes
This program shouldn't violate any ToS's of the websites included as it doesn't grab the download links. It still forwards to the original website, just the software's page of it.
#### Contribution
Can be directly done by using https://sqlitebrowser.org/ and opening the database file, you can also check the Wiki page for contribution.