Skip to content

roflsunriz/filter-matome

BranchesTags

Repository files navigation

filter-matome

License: MIT GitHub release Latest Version

filter-matomeは、ニコニコ動画の視聴体験を大幅に向上させる高機能な拡張機能群です。視聴履歴の無制限保存、強力なコメントフィルター、マイリスト2、動画プレイヤー拡張など、多彩な機能を提供します。

機能プレビュー

watch-history

watch-history

mylist2

mylist2

comment-filter2

comment-filter2

video-player

video-player

mlink-video-controller

mlink-video-controller

✨ 主な機能

🎯 コア機能

  • 視聴履歴: ブラウザ容量の許す限り無制限で履歴を保存・統計表示、シリーズ追跡、検索・フィルタ
  • マイリスト2: 複数マイリスト作成、検索、ソート、一括操作、検索ワード保存
  • コメントフィルター2: 公式NGワードを遥かに凌ぐ強力なフィルタリング機能、NGユーザー・ニコる数設定、コメントコマンド設定、フィルターログ送信
  • 動画プレイヤー拡張: 有料動画キャッシュ再生、削除済み・視聴不可動画のローカル再生、HLS対応、コメント描画・同期機能、ウォッチページ取得失敗時のnicochart.jp動画情報フォールバック
  • マルチリンクビデオコントローラー: 再生速度調整、フレーム単位シーク、音量微調整、コメントヒートマップ、サムネイルフィルター、原宿風Watch表示、モジュール管理

🛠️ 拡張機能

  • 背景画像設定: 視聴ページの背景をカスタマイズ
  • プレミアム勧誘非表示: 煩わしい勧誘要素を完全除去
  • コメントヒートマップ: 盛り上がり箇所を視覚化
  • キャッシュ一覧管理: NicoCache_nlのキャッシュ一覧を検索・フィルタ・ソート・削除
  • 動画/API情報ダッシュボード: 動画IDから複数APIの情報を横断表示

📦 導入方法

前提条件

winget install EclipseAdoptium.Temurin.17.JDK
winget install EclipseAdoptium.Temurin.21.JDK
  • Apache Ant
  • Bouncy Castle (PKIX/CMS/EAC/PKCS/OCSP/TSP/OPENSSL(bcpkix), Provider(bcprov), ASN.1 Utility Classes(bcutil))
  • 対応ブラウザ: Firefox(推奨)
winget install Mozilla.Firefox.ja
winget install Google.Chrome

インストール手順

  • リリースアーカイブのルートには GUIDE.html を同梱しています。USAGE GUIDE と NicoCache_nl SETUP GUIDE への入口として使えます。

  1. NicoCache_nl本体の導入

    # NicoCache_nl Usage Guideを参照してインストール

    インストール方法

  2. フィルター群の配置

    # ディレクトリ構造を維持して以下に配置
NicoCache_nl/
├── nlFilters/     # 100-199番台のDSLフィルター
├── local/         # 拡張機能のコンパイル済みファイル、ソースコード
└── extensions/    # 追加拡張機能のコンパイル済みファイル、ソースコード

  3. 設定の有効化

    • NicoCache_nlを起動
    • ブラウザでハード再読み込み（Ctrl+F5）

クリーンインストール

# 既存の100-199番台フィルターを削除
# extensions,local,nlFiltersにあるファイルをダウンロードファイルを見ながら削除(必要なファイルを間違えて消さないため)
# 新しいファイルで上書き更新
# 設定のインポート（必要に応じて）

📖 機能詳細

視聴履歴 (watch-history)

  • 無制限履歴保存: ニコニコ動画の50件制限を突破
  • 高度な統計: 日別視聴状況・時間帯別視聴状況
  • シリーズ追跡: NicoCache_nl常駐extensionを正本とするアラート管理、ページ非表示時の新規投稿通知・シリーズナビゲーション
  • 検索・フィルタ: 強力な検索・ソート機能
  • メモ機能: 履歴にメモを残せる
  • インポート/エクスポート: データの移行・バックアップ

マイリスト2 (mylist2)

  • 複数マイリスト: 無制限でマイリスト作成
  • 高度な管理: 検索、ソート、一括操作
  • インポート/エクスポート: データの移行・バックアップ
  • API連携: 自動情報取得・更新
  • 一括移動・コピー・削除・更新: 一括操作
  • 検索ワード保存: 検索ワードの保存

コメントフィルター2 (comment-filter2)

  • JSON Lines形式: 高度なルール設定
  • エクスポート・インポート: データの移行・バックアップ
  • 正規表現対応: 柔軟なパターンマッチング
  • リアルタイム処理: 高速なコメント処理
  • NGユーザー・ニコる数設定: NGユーザー設定によるフィルタリング、ニコる数条件による対象指定、条件一致コメントのフィルタ免除
  • コメントコマンド設定: "big"や"shita"や"red"などのコメントコマンドの設定
  • フィルターログ送信: CommentFilterExtensionへのフィルターログの送信

動画プレイヤー拡張 (video-player)

  • 期限切れ動画再生: キャッシュを活用した視聴継続
  • 削除済み動画対応: キャッシュが存在するが削除されてしまった動画の視聴
  • 視聴不可動画対応: ローカルキャッシュがある動画はスタンドアロンプレイヤーで再生
  • HLS対応: 最新のニコニコ動画仕様の対応
  • 同期機能: コメントと動画の完全同期
  • NGワード・NG正規表現: コメントのNGワード・NG正規表現

マルチリンクビデオコントローラー (mlink-video-controller)

  • リンク提供: mylist2, comment-filter2, watch-history, mylist2への追加ボタン、動画非表示設定、ニコニコ動画関連サービスへのリンク、キャッシュリスト、キャッシュ情報、nlMediaInfo, 音声保存、動画保存、コメント保存、キャッシュ削除
  • 再生速度調整: 再生速度の調整
  • 多彩なコントロールボタン: 再生・一時停止・次の動画・前の動画・繰り返し再生・シークバー・5秒スキップ・10秒スキップ・30秒スキップ・60秒スキップ
  • コメント検索: コメントの検索
  • フレーム単位シーク: フレーム単位でのシーク
  • 音量微調整: 音量の微調整
  • コメントヒートマップ: コメントの盛り上がり箇所を視覚化
  • サムネイルフィルター: キーワード・正規表現で動画サムネイルを非表示
  • 原宿風Watch表示: 視聴ページの表示を原宿風レイアウトへ変更
  • モジュール管理: ヘッダープライバシー、UI強化、視聴ページ機能強化、背景セレクター/背景画像設定、マトリックス背景、タブセッション拡張などを管理

キャッシュ一覧管理 (cache-data-manager)

  • 仮想スクロール: 大量キャッシュでも可視範囲のみ描画
  • 検索・フィルタ・ソート: 動画ID、タイトル、画質、ステータス、利用不可状態で絞り込み
  • 公開状態チェック: getthumbinfoで削除・非公開などを確認し、メタデータをIndexedDBへ保存
  • キャッシュ操作: テンポラリ動画の一括削除や個別操作を提供

動画/API情報ダッシュボード (movie-info)

  • 横断取得: cache/info、getthumbinfo、MediaInfo、watch apiDataを並列取得
  • コメント取得: 必要時だけ全フォークコメントを取得し、プレビューとフルJSON保存を提供
  • エラー表示: 一部API取得失敗時も成功したパネルを表示し、失敗元と確認ポイントを整理

🔧 開発者向け情報

技術スタック

  • 言語: TypeScript
  • ビルドツール・ランタイム: Bun（要求バージョンは local/features/package.json を参照）
  • 静的解析: ESLint、typescript-eslint
  • テスト: Bun test、Playwright
  • ストレージ: IndexedDB
  • UI: Material Design Icons
  • フィルター言語: nlFilter (NicoCache_nl独自DSL)

プロジェクト構成

local/
├─ background-images/    # 視聴ページ用の背景画像
└─┬── features/          # メイン機能群
  ├── src/               # TypeScriptソースコード
  │   ├── api-info/             # ニコニコ動画/API仕様メモ
  │   ├── cache-data-manager/   # NicoCache_nlキャッシュ一覧UI
  │   ├── comment-filter2/      # コメントフィルター
  │   ├── common/               # 共通ヘルパー、共通ヘッダー、ロガー、トースト
  │   ├── mlink-video-controller/ # 視聴ページ操作パネルとモジュール
  │   ├── movie-info/           # 動画/API情報ダッシュボード
  │   ├── mylist2/              # マイリスト2
  │   ├── runtime/              # 配信ページ判定と起動境界
  │   ├── types/                # 共通型定義
  │   ├── video-player/         # ローカル動画プレイヤー
  │   └── watch-history/        # 視聴履歴SPAと視聴追跡
  ├── tests/             # Bun単体テスト、Playwrightテスト、fixture
  ├── dist/              # Bunで生成した単一バンドル、Worker、静的HTML
  └── scripts/           # Bunビルド・テストスクリプト

nlFilters/
├── 100_features.txt                # 全機能を含むfeatures.jsをニコニコ動画全体へ挿入
├── 101_disable_official_function.txt # 公式機能無効化(公式プレーヤーの再生速度調整を無効化)
└── 105_premium_hide.txt            # プレミアム勧誘非表示(ニコニコ動画共通コモンヘッダーのプレミアム勧誘を非表示)

extensions/
├── FilterMatomeCacheControl.java/.class # MP4等を保持したままHLSだけを削除・削除予約するサーバーAPI
└── FilterMatomeSeriesAlerts.java/.class # シリーズ新着の定期確認とOS通知

docs/resources/            # USAGE.mdで使われる画像リソース

ビルド方法

cd local/features
bun install
bun run format
bun run lint
bun run type-check
bun run test
bun run build

features.jsへ全ブラウザ機能を統合するため、個別ビルドはありません。 構成、生成物、プロジェクト別READMEは local/features/README.md を参照してください。

NicoCache_nlの安全な終了

リポジトリルートのstop-nicocache.ps1は、コマンドラインに-jar ...\NicoCache_nl.jarがあるjava.exe / javaw.exeのPIDだけを特定して終了するWindows用スクリプトです。プロセス名だけでJavaプロセスを一括終了しません。

# 対象の確認だけを行う
.\stop-nicocache.ps1 -ListOnly

# NicoCache_nlの正常終了を試みる
.\stop-nicocache.ps1

# GUI操作と対話確認を省略し、指紋に一致したPIDだけを強制終了する
.\stop-nicocache.ps1 -SkipGuiShutdown -Force

GUI版ではNicoCache_nl本体の正常終了処理を呼び、既定で最大65秒待ちます。応答しない場合やGUIなしで起動している場合は、PIDと指紋を再確認した後に強制終了の確認を表示します。確認の既定値は「いいえ」です。CUI版や自動処理では-SkipGuiShutdownでGUI経路を、-Forceで対話確認を個別に省略できます。どちらを指定しても強制終了直前のPID、作成時刻、指紋の再確認は省略しません。実行内容だけを確認する場合は-WhatIfを指定できます。

nlFilter文法

[Replace]
Name = フィルター名
URL = 対象URL正規表現
Match<
置換対象テキスト
>
Replace<
置換後テキスト
>

[Script]
Name = スクリプト名
URL = 対象URL正規表現
Append<
挿入するJavaScriptコード
>

[Style]
Name = スタイル名
URL = 対象URL正規表現
Append<
追加するCSSコード
>

📚 ドキュメント

ドキュメント開発

pip install -r requirements-docs.txt
mkdocs serve

⚠️ 重要な注意事項

シンボリックリンク作成（必須）

NicoCache_nl はキャッシュデータマネージャを C:\NicoCache_nl\local\list.js という固定パス・固定名で参照します。ビルド成果物（例: features.js）へこの固定パス名でシンボリックリンクを作成しないと機能しません。詳細手順はガイドを参照してください。

使用上の注意

  • 全機能同時使用前提: 個別機能の抜き出しは動作保証外
  • データバックアップ: ブラウザデータ削除前に必ずエクスポート実行
  • 更新時の確認: CHANGELOG.mdを必ず確認してから更新
  • ハード再読み込み: 機能の有効/無効切り替え後はCtrl+F5実行

データ削除リスク

以下の操作でIndexedDBとローカルストレージの設定が消去されます：

  • サイトデータの削除
  • Cookieとサイトデータの削除
  • オフライン作業用データの削除
  • ブラウザデータの削除

注意: mylist2やcomment-filter2、watch-historyの視聴履歴はIndexedDBに保存されます。watch-historyのシリーズアラートはNicoCache_nl extensionが管理します。画面のエクスポートには履歴とアラートの両方が含まれるため、必ず安全な場所に退避してください！

🔗 関連リンク

コミュニティ

開発ツール

📄 ライセンス

MIT License - Copyright (c) 2017-2026 roflsunriz

私の名前を明記している限り、本ソフトウェアは自由に使用、複製、改変、配布、商用利用、非商用利用できます。詳細はLICENSEファイルをご覧ください。

🚀 リリース情報

最新バージョン

  • リリース形式: #300, #301 などの番号形式
  • リリース履歴: CHANGELOG.md

リリース作成方法（開発者向け）

# 次のバージョンタグを作成してプッシュ
git tag "#300"
git push origin "#300"
# 間違えてリリースを作った場合、タグを削除して再度リリースを作成
git tag -d "#300"
git push origin :refs/tags/#300

🤝 コントリビューション

プルリクエストや課題報告を歓迎します。大きな変更を行う前に、まずIssueを作成して議論することをお勧めします。

🙏 謝辞

このプロジェクトは多くのコミュニティメンバーの協力により成り立っています。特に、フィードバックやバグレポートを提供してくださった全ての方々に感謝いたします。

⚡ 高速・高機能・高カスタマイズ性 - filter-matomeでニコニコ動画を最大限に活用しましょう！

About

NicoCache_nl user experience enhancements

roflsunriz.github.io/setup-nicocache-nl/

Topics

css java html typescript niconico enhancements nicocache-nl

Resources

Readme

License

View license

Contributing

Contributing
Activity

Stars

4 stars

Watchers

2 watching

Forks

0 forks
Report repository

Releases 86

#233 Latest
Jul 14, 2026
+ 85 releases

Contributors

Languages