Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/m4heshd/offlinebay

Official repository of the project OfflineBay
https://github.com/m4heshd/offlinebay

electron javascript nodejs offlinebay torrent-search torrents

Last synced: 8 days ago
JSON representation

Official repository of the project OfflineBay

Host: GitHub
URL: https://github.com/m4heshd/offlinebay
Owner: m4heshd
License: mit
Created: 2018-06-02T05:53:25.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2022-12-07T03:42:58.000Z (almost 2 years ago)
Last Synced: 2024-11-05T03:36:55.463Z (9 days ago)
Topics: electron, javascript, nodejs, offlinebay, torrent-search, torrents
Language: JavaScript
Size: 935 KB
Stars: 121
Watchers: 15
Forks: 23
Open Issues: 20
Metadata Files:
- Readme: README.md
- Changelog: changelog.txt
- License: LICENSE

Awesome Lists containing this project

README

OfflineBay by m4heshd

Stable version: [**`2.0.0`**](https://github.com/m4heshd/offlinebay/releases/tag/2.0.0)

OfflineBay is a free and open-source tool created to hold and parse copies of torrent archive dumps. So it allows you to search and download torrents offline. OfflineBay can parse CSV files with many torrenting related added features. The parsing is programmed to match the structure of dump files created by The Pirate Bay. But any group or organization can follow that same structure to create dump files to be used with OfflineBay.

**[PLEASE FOLLOW THIS VIDEO TUTORIAL BEFORE YOU START USING OFFLINEBAY](https://www.youtube.com/watch?v=nNjW_OUv-hE)**

### DISCLAIMER:
> **OfflineBay is Free and Open-source software licensed under [MIT License](LICENSE). This software is created to parse CSV dump files created by a third party and any of the data other than this software is not provided by m4heshd. Use the data at your own risk. m4heshd will not be responsible for any of the data acquired using dump files. It is strongly advised not to use OfflineBay for any copyright infringing activities. OfflineBay will not hide or protect you from authorities if you engage in such activities.**

# Downloads

OfflineBay is distributed as a portable application in favor of the majority. Download the corresponding package and extract the **ZIP** file. All of the packages should have an executable (double-clickable) along with some other files. File named `OfflineBay.exe` or `OfflineBay.app` or `OfflineBay` would be the executable file.

**NOTE:** Linux users may need to declare the file as an executable before running - `chmod +x OfflineBay`

**Why downloads are larger than the previous version?**

Well, OfflineBay 2 is created using [Electron](https://electronjs.org) and NodeJS. So the disk footprint could be a [little concerning](https://github.com/electron/electron/issues/2003). There is no way around this issue. This is one small compromise for a lot of improvements.

- [All releases (with source)](https://github.com/m4heshd/offlinebay/releases)
- Windows (x86 & x64) - [Download](https://github.com/m4heshd/offlinebay/releases/download/2.0.0/OfflineBay-2.0.0-Windows.zip)
- MacOS - [Download](https://github.com/m4heshd/offlinebay/releases/download/2.0.0/OfflineBay-2.0.0-MacOS.zip)
- Linux (x64) - [Download](https://github.com/m4heshd/offlinebay/releases/download/2.0.0/OfflineBay-2.0.0-Linux-x64.zip)
- Linux (x86) - [Download](https://github.com/m4heshd/offlinebay/releases/download/2.0.0/OfflineBay-2.0.0-Linux-x86.zip)

**WARNING:** Since OfflineBay is now open-source you could stumble upon some modified versions of OfflineBay. If you get infected with malware by going off the proper channels, i won't take any blame for them.

If you're looking for the older version of OfflineBay, Downloads are available [here](https://pirates-forum.org/Thread-Release-OfflineBay-1-0-2-Download-torrents-from-thePirateBay-offline).

**How to remove OfflineBay?**

I personally believe that none of the applications should leave any residue in the removal process. Unlike other portable apps OfflineBay will not leave anything behind once you hit delete on the application folder. It's valid for all platforms. Everything will be removed including Dump files, configurations and error logs.

# Build OfflineBay yourself

You will need [NodeJS](https://nodejs.org) and [NPM](https://www.npmjs.com/) (Usually packed with NodeJS) installed on your computer to build OfflineBay yourself.

**NOTE:** When creating OfflineBay i almost managed to completely avoid native modules. But there's a single module named `bufferutil` that's required by another module. You may run into a few errors when building if you don't have platform build tools for `node-gyp`. You can simply ignore those errors since the module is an optional dependency. Also since OfflineBay practically has no native dependencies, it's possible to cross-build without any complications. But i cannot guarantee on the outcome.

Clone this repository, `cd` to that directory and run `npm run clean` before everything. Then run any of the following commands to build OfflineBay.

- Windows (x86 & x64) - `npm run dist-win`
- MacOS - `npm run dist-mac`
- Linux (x64) - `npm run dist-linux-64`
- Linux (x86) - `npm run dist-linux-32`

# Support OfflineBay project

Involvement as a contributor by adding a few lines of code, fixing a bug, respond to issues, testing etc.. would be one of the most helpful methods you could support the project. If you're not a programmer but a creative person, you could definitely get involved in the GUI part of OfflineBay. [Follow this link to learn about theming for OfflineBay](https://github.com/m4heshd/offlinebay-themes).
If you have some spare coins laying around, you could throw some this way to buy me a coffee..

- **BTC:** 1KpjcftYs8CnG7jVgmzSoKAVT7QGqisYBC
- **ETH:** 0x1EE4130876B4f0aD2303a98787fd3746DD0C84F4
- **BCH:** 1LsY4Ppvrfx21pzs7YaAC3ciLbdwUYj92q

[![Donate to m4heshd](https://i.ibb.co/3vQTMts/paypal-donate-icon-7.png)](https://www.paypal.me/mpwk?locale.x=en_US)

Or you can buy me a "ko-fi" by clicking this button

[![ko-fi](https://i.ibb.co/QmQknmc/ko-fi.png)](https://ko-fi.com/m4heshd)

# Got an Issue?

[Follow this link](https://github.com/m4heshd/offlinebay/issues) to submit your issues. Remember to be descriptive when submitting issues. Also remember that issues area is not meant to ask for help. If you need help or you have any other questions regarding OfflineBay you can simply fire up a conversation on the [Suprbay thread](https://pirates-forum.org/Thread-Release-OfflineBay-v2-Open-source-and-No-more-Java-dependency).
# Known issues

**Linux:**

- Splash window may have a [white background instead of transparency](https://github.com/electron/electron/issues/2170) [`unfixable/SW-HW dependent`]
- DHT scraping may not work sometimes [`unable to trace the issue`]

# Themes you say?

You can create themes for OfflineBay just using CSS. [This repository](https://github.com/m4heshd/offlinebay-themes) is dedicated to OfflineBay themes. Visit there to learn more about creating themes.

If you're a regular user, you can also follow the [same repository](https://github.com/m4heshd/offlinebay-themes) to download themes.

# Changelog

Complete Changelog is available [here](changelog.txt).

# License
OfflineBay is licensed under [MIT License](LICENSE). So you are allowed to use freely and modify the application. I will not be responsible for any outcome. Proceed with any action at your own risk.