Skip to content

Latest commit

 

History

History
297 lines (229 loc) · 16 KB

README.md

File metadata and controls

297 lines (229 loc) · 16 KB
Raw

KissNetwork

Codacy Badge GitHub issues

Table of Contents

Introduction

This plugin creates a new channel within Plex Media Server (PMS) to view content from these websites: Kissanime.ru, Kissasian.com, Kisscartoon.se, Kissmanga.com, and ReadComicOnline.to. It is currently under development and as such, should be considered alpha software and potentially unstable. If you try it and it works for you (or if not!) please let me know.

Note: the author of this plugin has no affiliation with the Kiss sites nor the owners of the content that they host.

Table of Contents

Features

  • Watch video content across all Kiss sites (quality ranges from 360p to 1080p)
  • Choose which sites to view content, hide others
  • Option to Block most Adult content
  • Read Manga from KissManga
  • Read Comics from ReadComicOnline
  • Create custom Bookmarks
  • Search all sites for Videos/Manga/Comics

Table of Contents

Changelog

Table of Contents

Channel Support

Plex Media Server:
  • Tested Working:
    • Ubuntu 14.04 LTS: PMS version 1.4.2
    • Windows 7: PMS version 0.9.16.6 (untested since v1.2.1)
Plex Clients:
  • Tested Working:
    • Plex Home Theater (Ubuntu 14.04 LTS, v1.4.1)
    • OpenPHT (Ubuntu 14.04 LTS, v1.6.2)
    • Android (4.4.2) (Plex Client App, v5.6.1.505)
    • Android (7.1.1) (Plex Client App, v5.6.1.505)
    • Plex Media Player (1.1.4)
    • Plex/Web (3.0.1) (Videos)
    • Chromecast (Videos & Pictures)

Table of Contents

Install

  • This channel can be installed via WebTools.bundle or manually follow the directions below.
  • Download the latest release and install KissNetwork by following the Plex instructions or the instructions below.
    • Unzip and rename the folder to KissNetwork.bundle
    • Copy KissNetwork.bundle into the PMS Plug-ins directory
    • Unix based platforms need to chown plex:plex -R KissNetwork.bundle after moving it into the Plug-ins directory (user:group may differ by platform)
    • Restart PMS

Table of Contents

Operation

Preferences

Simple UI
  • Remove all sub list in favor of one list per section sorted by the Sort List by... option.
Sort List by...
  • Set list order for "All", "Alphabets", "Country", "Genres", "Movies", "Ongoing", and "Completed"
View Anime, Cartoon, Comic, Drama, Manga
  • If site enabled then it will be availible in the Channel for viewing. This includes Bookmarks and Searching.
Preferred Video Server
  • Select a Default Video Server from the drop-down list
  • Currently supported servers: KissNetwork(default), Openload, Stream
    • Default behavior: Use GoogleVideo links when available, otherwise try using the provided links
    • If a server other than KissNetwork is selected: Use selected video server, and default to GoogleVideo links when selected server fails.
Search all sites together
  • Enabled: Check all sites before results are returned. This will removed categories with empty results but will slow down search when sites preform a header refresh.
  • Disabled(default): Do not search all sites at once, instead check a site only when asked.
Hide "Clear Bookmarks"
  • Enabled: Hide the Clear Bookmarks function within Main Bookmarks menu and sub-menus
  • Disabled(default): Allow the Clear Bookmarks function within Main Bookmarks menu and sub-menus
Use "Custom Bookmarks Backup Path"
  • Enabled: Use Custom Bookmarks Backup Path to store bookmark backup json files
  • Disabled(default): Use default path, located within the channel's support directory
Custom Bookmarks Backup Path
  • Custom user path to save bookmark backup json files
  • Plex must have read/write permissions to use an external directory, otherwise backup path will fallback to default location
Force Redirect (disables remote play)
  • Enabled: Turns On URL Redirect Function, making PMS follow the URL Redirect.
    • Follows URL through its redirect and returns the final URL
    • GoogleVideo Links: expand around PMS IP rendering unusable outside of local network (i.e. remote play disabled)
  • Disabled(default): URL Redirect is handled by client
Force Transcoding (enables remote play)
  • Openload/Stream.moe videos have a hash tied to the PMS server IP. Enable to watch Openload/Stream.moe videos outside the PMS local network.
  • Enabled: Videos will be transcoded by PMS and available for use outside the servers network
    • Resolution will depend on available streams and client settings
    • Overrides Force Redirect, because PMS will properly handle any URL Redirects
  • Disabled(default): Transcoding depends on clients settings/support
Allow Adult Content
  • Enabled: Allows Adult Content to be viewed
  • Disabled(default): Checks against contents Genre list for adult themed genres. Current block list.
    • Will provide a popup whenever an Adult themed video/comic/manga is accessed providing feedback as to why the content is blocked
    • Fails with KissCartoon because it does not have Adult themed Genres but does have Adult content
Enable Developer Tools
  • Enabled: Show Developer Tools Menu located in About / Help section
  • Disabled(default): Developer Tools Menu remains hidden
  • Is only available to PMS admin regardless of enabled/disabled
Auth Admin Through Plex.tv
  • Authenticate admin user through Plex.tv if Plex Media Server does not have Plex Home enabled
  • Enabled: Auth against https://plex.tv/user/account
    • Use if PMS is NOT setup as Plex Home
    • If plex.tv is down then this authentication will fail, locking the admin out from channel Preferences, Updater, and DevTools section
      • If this happens, open Plug-in Support/Preferences/com.plexapp.plugins.kissnetwork.xml and set plextv section to false. Save and exit file.
      • Note 1: if PMS is not setup as Plex Home then admin features will now be available to all shared users
      • Note 2: when plex.tv comes online again, make sure to re-enable Auth Admin Trough Plex.tv to ensure shared users are not allowed admin access
  • Disabled(default): Auth against http://127.0.0.1:32400/myplex/account
    • Use when PMS is setup as Plex Home
    • Note: If PMS NOT setup as Plex Home then all shared users will have admin access
  • If using Plex Web Client on Host Server Machine and not signed-in, then no Plex Token will be available to authenticate. In this use case, the assumption is you are the admin so the channel will treat you as such.
Update Channel
  • Select channel to track updates from. Updater caches the Github request URL for 12 hours.
  • Update button visible only to PMS admin and when update avalible.
  • Stable(default): Tracks the latest release, same as the old updater
  • Development: Tracks the latest commit within the dev branch
Enable Debug Logging
  • Turn on extra logging for debugging purposes

Table of Contents

About / Help

Developer Tools
Cartoon Upgrade
  • One time use, to prepare channel for use with new KimCartoon temporary source
  • Note: this is only temporary until KissCartoon comes back online
Bookmark Tools
  • Backup Tools:
    • Backup Bookmarks - Creates a Backup file of all bookmarks
    • Delete Backups - Open menu to Detele old bookmark backups
    • Load Bookmarks from Backup - Open menu to Load bookmarks from previously created backup file
  • Toggle Hiding "Clear Bookmarks" Function: For those of us who accidentally delete our bookmarks but don't mean to
  • Reset "All" Bookmarks: Same as "Clear All Bookmarks"
  • Reset "Anime" Bookmarks: Same as "Clear Anime Bookmarks"
  • Reset... : Same for Drama, Cartoon, Comic, and Manga
Cache Tools
  • Reset DataCovers Cache: Force Remove all cached Covers from DataCovers directory.
  • Reset DataHTTP Cache: Force Remove all cached URLs from DataHTTP directory.
Domain Tools
  • Reset Domain_Dict File: Create backup of old Domain_Dict, then delete current, and write new Domain_Dict with freash domains
  • Update Anime Domain: Update Anime Domain in the Domain_Dict file only
  • Update... : Same for Drama, Cartoon, Comic, and Manga
Header Tools
  • Reset Header_Dict File: Create backup of old Header_Dict, then delete current, and write new Header_Dict with freash headers
  • Update Anime Headers: Update Anime Headers in the Header_Dict file only
  • Update... : Same for Drama, Cartoon, Comic, and Manga

Table of Contents

Issues

General
  • First time channel runs after installation or an upgrade, you may see a message saying to wait untile the headers are cached. This is normal behavior.
  • Episode, Movie, VideoClip data may be incorrect depending on how the shows are archived on the Kiss sites. I've accounted for most variations but some info will still be incorrect.
Anime, Cartoon, Drama, Manga, Comics
  • Hosted behind Cloudflare so added a modified version of cloudflare-scrape as a work around
Cartoon
  • No Mature filter/genre so Adult Prefs Option cannot filter out Adult Cartoons
Manga, Comics
  • Kissmanga/ReadComicOnline is not the most useful reader for the Plex Web client, but works reasonably well for Smart Phones, PMP, and PHT.
Drama
  • Keeps changing video URL obfuscation every so often. Am able to decode daily, but will not be creating a new release every day it changes. Depends on current frequency of changes.
  • If and when Drama videos start failing (when obfuscation changes), users can try the dev branch code, or Switch the server pref to Openload or Stream.
  • Header Cache time is very short, ~30-45 minutes, so can bog down Search Function
Plex Home Theater
  • Channel exits when adding/removing bookmarks. Has to do with pop up messages.
    • Working to fix this. Have new message.py but have yet to integrate with bookmarks fully
Plex Web Client
Openload, Stream
  • Openload/Stream.moe links have a hash tied to your PMS IP. To use these Servers outside your home network, enable Force Transcoding. Force transcoding will make video links compatible with all clients.
Stream.moe
  • Stream.moe host is offline. Left it's code alone for now, as it does not affect channel preformance. Waiting to see if the site returns.

Table of Contents

Plans

General
  • Continue Improving Metadata
  • Change Itempage to TVShowObject, so have Bookmark function within TVShowObject.
Bookmarks
  • Group seasons into one show
  • Might create separate directories for TV and Movies
  • Might move bookmarks to own file like I did with Header_Dict

Table of Contents

Support

Table of Contents

About

Hey you, you scrolled to the end of the page! Yeah

Little background to this project. I decided it was time I start learning some Python, so what better way than to learn it and get some fun results to play with.

Mangahere.bundle (based off of Mangafox.bundle) was my first attempt at creating a new channel. I soon realized that the URL ServiceCode could not handle pulling consecutive page images, so I set out to find a site that presented all the album images on one page per chapter. Thus KissManga.bundle was born. Once I got the basics down for Kissmanga I noticed that the other Kiss sites were created similarly and would take some tweaking of my code to crawl each site.

This prompted me to make KissNetwork.bundle. I've tried to use Plex's built in framework as much as possible in hopes of maximizing cross platform compatibility. It has been a fun project so far and has gotten me more comfortable with Python. Have fun with it and let me know of any other issues or suggestions of how to make this faster and more user friendly.

Table of Contents