{"id":13549752,"url":"https://github.com/NNTmux/newznab-tmux","last_synced_at":"2025-04-02T23:31:12.007Z","repository":{"id":19362670,"uuid":"22602573","full_name":"NNTmux/newznab-tmux","owner":"NNTmux","description":"Laravel based usenet indexer","archived":false,"fork":false,"pushed_at":"2025-03-31T07:10:06.000Z","size":203579,"stargazers_count":223,"open_issues_count":0,"forks_count":56,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-04-01T00:32:26.341Z","etag":null,"topics":["apache","gplv3","indexer","laravel","mariadb","newsgroups","nginx","nntp","nzb","php","sphinx","tmux","usenet"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NNTmux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"DariusIII","patreon":"DariusIII"}},"created_at":"2014-08-04T12:03:17.000Z","updated_at":"2025-03-31T07:09:27.000Z","dependencies_parsed_at":"2023-10-14T16:23:22.501Z","dependency_job_id":"9afa9eba-e733-45d9-9f75-5b4a78b41261","html_url":"https://github.com/NNTmux/newznab-tmux","commit_stats":{"total_commits":13642,"total_committers":32,"mean_commits":426.3125,"dds":"0.11098079460489663","last_synced_commit":"3d2b613665373a2a90bc12d6c8128a667d437ce0"},"previous_names":[],"tags_count":64,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NNTmux%2Fnewznab-tmux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NNTmux%2Fnewznab-tmux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NNTmux%2Fnewznab-tmux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NNTmux%2Fnewznab-tmux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NNTmux","download_url":"https://codeload.github.com/NNTmux/newznab-tmux/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246910913,"owners_count":20853652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apache","gplv3","indexer","laravel","mariadb","newsgroups","nginx","nntp","nzb","php","sphinx","tmux","usenet"],"created_at":"2024-08-01T12:01:25.114Z","updated_at":"2025-04-02T23:31:06.998Z","avatar_url":"https://github.com/NNTmux.png","language":"JavaScript","funding_links":["https://github.com/sponsors/DariusIII","https://patreon.com/DariusIII","https://www.patreon.com/bePatron?u=6160908"],"categories":["JavaScript","Usenet","PHP"],"sub_categories":["Usenet Indexers"],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://codeclimate.com/github/NNTmux/newznab-tmux\"\u003e\u003cimg src=\"https://codeclimate.com/github/NNTmux/newznab-tmux/badges/gpa.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://scrutinizer-ci.com/g/NNTmux/newznab-tmux/build-status/dev\"\u003e\u003cimg src=\"https://scrutinizer-ci.com/g/NNTmux/newznab-tmux/badges/build.png?b=dev\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://scrutinizer-ci.com/g/NNTmux/newznab-tmux/?branch=dev\"\u003e\u003cimg src=\"https://scrutinizer-ci.com/g/NNTmux/newznab-tmux/badges/quality-score.png?b=dev\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://travis-ci.org/NNTmux/newznab-tmux\"\u003e\u003cimg src=\"https://travis-ci.org/NNTmux/newznab-tmux.svg?branch=dev\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/nntmux/newznab-tmux\"\u003e\u003cimg src=\"https://poser.pugx.org/nntmux/newznab-tmux/v/stable.svg\" alt=\"Latest Stable Version\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://packagist.org/packages/nntmux/newznab-tmux\"\u003e\u003cimg src=\"https://poser.pugx.org/nntmux/newznab-tmux/license.svg\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://styleci.io/repos/22602573\"\u003e\u003cimg src=\"https://styleci.io/repos/22602573/shield?branch=dev\" alt=\"StyleCI\"\u003e\u003c/a\u003e\n    \u003ca href='https://coveralls.io/github/NNTmux/newznab-tmux?branch=0.x'\u003e\u003cimg src='https://coveralls.io/repos/github/NNTmux/newznab-tmux/badge.svg?branch=dev' alt='Coverage Status' /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/prettier/prettier\"\u003e\u003cimg src=https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.patreon.com/bePatron?u=6160908\"\u003e\u003cimg src=\"https://c5.patreon.com/external/logo/become_a_patron_button.png\" alt=\"Become a Patron!\" height=\"35\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n\nNNTmux automatically scans usenet, similar to the way google search bots scan the internet. It does this by collecting usenet headers and temporarily storing them in a database until they can be collated into posts/releases. It provides a web-based front-end providing search, browse, and programmable (API) functionality.\n\nThis project is a fork of the open source usenet indexer newznab plus: https://github.com/anth0/nnplus and open source nZEDb usenet indexer https://github.com/nZEDb/nZEDb\n\nNNTmux improves upon the original design, implementing several new features including:\n\n- Optional multi-threaded processing (header retrieval, release creation, post-processing etc)\n- Advanced search features (name, subject, category, post-date etc)\n- Intelligent local caching of metadata\n- Tmux (terminal session multiplexing) engine that provides thread, database and performance monitoring\n- Image and video samples\n\n\n## Prerequisites\n\nSystem Administration know-how. NNTmux is not plug-n-play software. Installation and operation requires a moderate amount of administration experience. NNTmux is designed and developed with GNU/Linux operating systems. Certain features are not available on other platforms. A competent Windows administrator should be able to run NNTmux on a Windows OS.\n\n### Hardware\n\n\t64GB RAM, 8 cores(16 threads) and 320GB disk space minimum.\nIf you wish to use more than 5 threads an eight core CPU is beneficial.\n\nThe overall speed of NNTmux is largely governed by performance of the database. As many of the database tables should be held within system RAM as possible. See Database Section below.\n\n### Software\n\n\tPHP 8.2+ (and various modules)\n\tMariaDB 10+ or MySQL 8+ (Postgres is not supported)\nThe installation guides have more detailed software requirements.\n\n### Database\n\nMost (if not all) distributions ship MySQL with a default configuration that will perform well on a Raspberry Pi. If you wish to store more that 500K releases, these default settings will quickly lead to poor performance. Expect this.\n\nAs a general rule of thumb the database will need a minimum of 1-2G buffer RAM for every million releases you intend to store. That RAM should be assigned to this parameter:\n\n- innodb_buffer_pool_size\n\nUse [mysqltuner.pl](http://mysqltuner.pl \"MySQL tuner - Use it!\") for recommendations for these and other important tuner parameters. Also refer to the nZEDb project's wiki page: https://github.com/nZEDb/nZEDb/wiki/Database-tuning. This is particularly important before you start any large imports or backfills.\n\n\n## Installation\n\n Follow NNTmux Ubuntu install guide:\n\n https://github.com/NNTmux/newznab-tmux/wiki/Ubuntu-Install-guide\n\n For composer install and getting NNTmux follow this guide:\n\n https://github.com/NNTmux/newznab-tmux/wiki/Installing-Composer\n\n## Docker\n\n NNTmux uses Laravel Sail to manage docker container. To start docker container, edit your .env and then run:\n\n ```./sail up -d```\n\n### Support\n\n Support is given on discord: https://discord.gg/GjgGSzkrjh\n\n### Licenses\n\n NNTmux is GPL v3. See LICENSE.txt for the full license.\n\n All external libraries will have their full licenses in their respectful folders.\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNNTmux%2Fnewznab-tmux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FNNTmux%2Fnewznab-tmux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FNNTmux%2Fnewznab-tmux/lists"}