Skip to content

wasperversa-x/pSearch

 
 

Repository files navigation

Downloads Latest Downloads Latest Standalone Downloads Latest Onefile Downloads License Top Language

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
Description Running pSearch from the source code requires BeautifulSoup and CustomTkinter. Need to be familiar with Python and the libraries used. 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 auto-py-to-exe, more information can be found below. 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", in the package so the program would run in a correct way. Launching the program may take some time with this method.
Health Runs Fastest Runs Fast Runs Slow
Button Name on Site View Latest Release GitHub Download Latest .EXE for Windows Download Latest .EXE Onefile for Windows

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 Shortcuts buttons, which allows you to search immediately in multiple sites within a category
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 30 you can browse other pages by clicking the number buttons at the bottom of the page

Additional Note

Searching in ALL sites is time consuming, especially with slow wifi connections. I removed the button All from the Shortcuts, since it would be more efficient to strategically search in a category. However, you can still use "all" in the site input box to search everywhere since it is also a good way to test if all sites are working properly. It's in the dropdown menu too as the first entry.

Requirements and Running

This software uses BeautifulSoup and CustomTkinter. The program also uses https://github.com/Akascape/CTkScrollableDropdown to have the combobox auto show and search to find a website easily.

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/command prompt in the program's folder 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.

Additional Programs

  • 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). It is found in the others folder.

Notice

auto py to exe

To create executable files, I now use auto-py-to-exe (https://pypi.org/project/auto-py-to-exe/) with the following configs:

  • One for One file, one for One Directory
  • Console based
  • Apply the icon file: icon.ico that's in the source code
  • Additional files: add the folders media, others, online_json from others
  • Additional files: websites.json (not the one from online_json. online_json folder from the others folder must be empty and only include the .txt file.)
  • Advanced -> name -> pSearch
  • Advanced -> --hide-console -> minimize-late

OR with pyinstaller:

  • Standalone: pyinstaller --noconfirm --onedir --console --icon "D:\path\to\icon.ico" --name "pSearch" --hide-console "minimize-late" --add-data "D:\path\to\media;media/" --add-data "D:\path\to\others;others/" --add-data "D:\path\to\others\websites.json;." --add-data "D:\path\to\others\online_json;online_json/" "D:\path\to\pSearch.py"
  • Onefile: pyinstaller --noconfirm --onefile --console --icon "D:\path\to\icon.ico" --name "pSearch" --hide-console "minimize-late" --add-data "D:\path\to\media;media/" --add-data "D:\path\to\others;others/" --add-data "D:\path\to\others\websites.json;." --add-data "D:\path\to\others\online_json;online_json/" "D:\path\to\pSearch.py"

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 opening the database file from the /others/ folder named websites.json using any software, you can also check the Wiki page for extra information. Thanks for adding/removing sites that are needed to be added/removed, and make sure to mention from where (which megathread) you got the site's name so I'd know.

About

Searching tool written in Python for Piracy related websites.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%