Giter Site home page Giter Site logo

sabnzbd-knockstrap's Introduction

Knockstrap

What is this?

Knockstrap is a theme for SABnzbd, the popular automated Usenet download tool. It brings a larger, more modern, brighter and cleaner look to one of your favorite tools.

Features

  • Clean interface: Large fonts, clean layout, easy to navigate
  • Responsive design: looks great on all your devices
  • Rewritten: Completely rewritten from scratch, not based on Plush
  • Update system: it will inform you when a new version of Knockstrap is available
  • Uses KnockoutJS and Bootstrap

How to I install it?

  • Download the latest version
  • Extract the Knockstrap folder into /path/to/sabnzbd/interfaces/knockstrap
  • Select Knockstrap from the available skins (config->general->skin)
  • Restart SABnzbd to see the changes take effect

Alternatively, you can clone directly from GitHub and I trust you to know how to do that.

It's missing something!

Yes I'm aware that despite my best efforts this still lacks in a few aspects behind the built-in Plush theme. Good news though, this is GitHub! So, fork the project, grab your favorite text editor, make the changes you need and send me a pull request.

Code? I only want to change the look...

So you know CSS? Right on, I made it so that you can easily change the look and feel while keeping the code base. Fork the project, add a new CSS file as Knockstrap/templates/static/stylesheets/colorschemes/yourname.css. Next time you relaunch SABnzbd you will see your color scheme in the themes drop down as 'Knockstrap - yourname'. Cool huh?

Is it good enough to share with everyone else? I'd love to include it, send a pull request so that you can get proper credit.

Why did you do this?

Why does anyone do anything? I got bored. Well, I also wanted a theme that would play well on both mobile and desktop, since mobile and tablet are quickly becoming my #1 way of using this tool. SABnzbd offers a secondary mobile skin, but separate sites for desktop and mobile? How 2005. I needed a responsive design. I found that there were some core layout problems and oddities that stopped me from giving this kind of responsive makeover to Plush. So I needed to redo this from scratch and the fastest way I knew how was Twitter's Bootstrap. So out of the box Knockstrap is responsive and looks great at any screen size.

While I was at it, I wasn't going to use Cheetah's somewhat arcane markup language either. Template files with special markup that get parsed on the server on every request? No thanks. So I was going to rebuild this as a client side javascript app, pulling info as needed from the available json api. Client side MVVM anyone? Enter Knockout.

Combine these two and you have the magic sauce for a beautiful and responsive client side application worthy of SABnzbd. Hope you enjoy!

I need to contact you!

Ok, follow me on Twitter @aforty, or head over to the original forum thread and post your thoughts or questions.

sabnzbd-knockstrap's People

Contributors

aforty avatar beingtomgreen avatar jharlap avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.