Spoolman
スプールの使用量をリアルタイムで追跡する、セルフホスト型の3Dプリンター消耗品管理サービス。
スマートダウンロード
プロジェクトのホームページへ
インストーラはまだありません — ソースリポジトリをご覧ください
3Dプリント消耗品の在庫マネージャー。使用量を自動同期。
主な機能
- フィラメントのブランド、種類、スプールごとの使用量を追跡
- WebSocket経由でスプールの重量をリアルタイムに更新でき、手動での記録は不要
- Web管理インターフェースを内蔵し、追加・削除・編集・参照やカスタムフィールドに対応
- OctoPrint、Klipper/Moonrakerなどの主要なプリントソフトウェアとシームレスに統合
- SQLite、PostgreSQL、MySQL、CockroachDBなど複数のデータベースに対応
できないこと
- •デフォルトではSQLiteを使用しますが、本番環境ではより優れた同時実行性能を得るためにPostgreSQLまたはMySQLへの切り替えを推奨します。2. 初回使用時は消耗品を手動で追加するか、コミュニティデータベースからインポートする必要があります。コミュニティデータベースは不完全な場合があります。3. QRコードラベルには感熱プリンターまたはラベルプリンターが必要です。それらがない場合は手動での管理のみ可能です。4. プリントソフトウェアでWebSocketが正しく設定されていない場合、リアルタイム更新が遅延する可能性があるため、ネットワークの接続性を確認してください。
使用例
- 個人の3Dプリント愛好者が自宅で複数種類のフィラメントを管理する
- 3Dプリントファームやワークショップが複数のプリンターのフィラメント在庫を集中管理する
- 印刷の使用量を自動記録し、コストの集計と補充を行う必要がある
詳細説明
Spoolmanは、3Dプリンティング愛好家やメーカーがフィラメント在庫を効率的に管理できるようにする、軽量なセルフホスト型Webサービスです。中央データベースとして、メーカー、フィラメントタイプ、個々のスプール情報を記録し、内蔵のWebクライアントで追加・削除・変更・参照が可能です。このサービスはOctoPrint、Klipper/Moonrakerなどとシームレスに統合され、印刷中にWebSocketを介してリアルタイムで同期し、スプールの重量を自動的に更新します。複数のデータベース（SQLite、PostgreSQL、MySQL、CockroachDB）に対応し、複数のプリンターを同時に管理できるほか、監視データをPrometheusに送信して履歴分析を行うことも可能です。Spoolmanには、コミュニティによってメンテナンスされるフィラメントデータベース（SpoolmanDB）や、QRコードラベル印刷機能も含まれています。インストールは簡単で、Dockerまたは手動デプロイに対応しています。
トラブルシューティング & FAQ (1)
トラブル対応DockerでMySQL 8.xに接続する際の'cryptography package is required'エラーの修正方法
Python環境に cryptography パッケージをインストールするか、PyMySQL[rsa] / aiomysql[rsa] を使用してください。Dockerデプロイメントの場合、エントリーポイントまたはDockerfileに pip install cryptography を追加してください。この問題は、MySQL 8.x がデフォルトで caching_sha2_password を使用しているため発生します。この認証方式には cryptography ライブラリが必要です。この依存関係はデフォルトのSpoolman設定では不足しています。追加すれば、MySQLのセキュリティをダウングレードすることなく接続に成功します。
タグ
はじめ方
ソフトウェアをインストール
ダウンロードしたインストーラをダブルクリックし、指示に従ってください
方法1（推奨）：Dockerを使って実行：docker run -d --name spoolman -p 7912:7912 -v $(pwd)/data:/app/data ghcr.io/donkie/spoolman:latest
方法2：GitHub Releasesからお使いのシステムに対応するバイナリファイルをダウンロードし、解凍後そのまま実行（事前にデータベースのインストールと設定が必要）
起動後、ブラウザでhttp://localhost:7912にアクセスし、ウィザードに従って管理者アカウントとデータベースを初期化
- 方法1（推奨）：Dockerを使って実行：docker run -d --name spoolman -p 7912:7912 -v $(pwd)/data:/app/data ghcr.io/donkie/spoolman:latest
- 方法2：GitHub Releasesからお使いのシステムに対応するバイナリファイルをダウンロードし、解凍後そのまま実行（事前にデータベースのインストールと設定が必要）
- 起動後、ブラウザでhttp://localhost:7912にアクセスし、ウィザードに従って管理者アカウントとデータベースを初期化
チェックサムがありません
このプロジェクトは GitHub Release ページに SHA-256 チェックサムを公開していません
SHA256 チェックサム
チェックサムなし
GitHub Releases から直接ダウンロードし、ファイルの整合性をご自身で確認してください
本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。
オープンソースの透明性
GitHub ソースを見るアンインストール情報
Dockerを使用している場合：docker stop spoolman && docker rm spoolman && rm -rf ./data 手動でインストールした場合：展開したディレクトリと関連するデータベースファイルを削除するだけです。
追加の依存関係なし
ダウンロード後すぐに使用可能。追加のランタイムは不要です。
問題が発生？以下のFAQを確認
1 FAQ