{"id":13678784,"url":"https://github.com/cgwire/kitsu-publisher-next","last_synced_at":"2025-12-24T14:19:51.212Z","repository":{"id":40368605,"uuid":"396797967","full_name":"cgwire/kitsu-publisher-next","owner":"cgwire","description":"Send previews from your DCC to the Kitsu Collaboration Platform ","archived":false,"fork":false,"pushed_at":"2023-03-20T14:42:56.000Z","size":1645,"stargazers_count":22,"open_issues_count":3,"forks_count":7,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-08-02T13:24:41.688Z","etag":null,"topics":["animation","cgi","vfx"],"latest_commit_sha":null,"homepage":"","language":"Vue","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/cgwire.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2021-08-16T13:04:39.000Z","updated_at":"2024-07-05T15:54:15.000Z","dependencies_parsed_at":"2024-08-02T13:29:21.054Z","dependency_job_id":null,"html_url":"https://github.com/cgwire/kitsu-publisher-next","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cgwire%2Fkitsu-publisher-next","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cgwire%2Fkitsu-publisher-next/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cgwire%2Fkitsu-publisher-next/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cgwire%2Fkitsu-publisher-next/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cgwire","download_url":"https://codeload.github.com/cgwire/kitsu-publisher-next/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224179117,"owners_count":17269006,"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":["animation","cgi","vfx"],"created_at":"2024-08-02T13:00:58.271Z","updated_at":"2025-12-24T14:19:51.180Z","avatar_url":"https://github.com/cgwire.png","language":"Vue","funding_links":[],"categories":["Official Repositories"],"sub_categories":[],"readme":"[![Kitsu](https://zou.cg-wire.com/kitsu.png)](https://kitsu.cg-wire.com)\n\n# Kitsu Publisher, send your files right from your DCC\n\nKitsu is a web application to share the progress of your productions and\nvalidate your deliveries. It improves the communication between all stakeholders.\nWhich leads to better pictures, shipped faster.\n\nThe Kitsu Publisher is a desktop application that connects DCC Tools to Kitsu.\nThrough it, your artists can see their todo list, comment tasks and send previews to Kitsu\ndirectly from their tools.\n\n[![Build\nbadge](https://travis-ci.com/cgwire/kitsu-publisher-next.svg?branch=master)](https://travis-ci.com/cgwire/kitsu-publisher-next)\n\n## DCC integrations status:\n\nAvailable:\n\n- Blender\n- Toon Boom Harmony\n- Unreal Engine\n\nWork in progress:\n\n- Maya\n- Adobe Photoshop\n\n## Installation\n\n### Installation of the Kitsu Publisher\n\n#### Pre-requisites\n\nYou need to download (or to build if you want to: see [Development Environment](#development-environment)) your preferred installer/package/portable for the app corresponding to your OS in the [releases](https://github.com/cgwire/kitsu-publisher-next/releases/latest).\n\nAll comands have the keyword {version} in the filenames, you need to replace the version with the current version of the Kitsu Publisher.\n\n#### On Linux\n\n- deb package (for debian based distributions):\n\n  - To install the package:\n\n    ```console\n    dpkg -i kitsu-publisher_{version}_amd64.deb\n    ```\n\n  - The package is now in your applications and in your $PATH.\n\n- rpm package (for RHEL based distributions):\n\n  - To install the package:\n\n    ```console\n    rpm -i kitsu-publisher_{version}_x86_64.rpm\n    ```\n\n  - The package is now in your applications and in your $PATH.\n\n- snap package:\n\n  - To install the package:\n\n    ```console\n    snap install kitsu-publisher_{version}_amd64.snap --dangerous\n    ```\n\n  - The package is now in your applications and in your $PATH.\n\n- tar.gz archive:\n\n  - To extract the archive:\n\n    ```console\n    tar -xf kitsu-publisher-{version}.tar.gz\n    ```\n\n  - To run the app:\n\n    ```console\n    kitsu-publisher-{version}/kitsu-publisher\n    ```\n\n- AppImage:\n\n  - to run the app:\n\n    ```console\n    ./Kitsu publisher-{version}.AppImage\n    ```\n\n#### On Windows\n\n- NSIS Installer:\n\n  - Double-click on the installer (Kitsu-publisher-Setup-{version}.exe) and follow the instructions.\n\n  - The package is now in your applications.\n\n- Msi installer:\n\n  - Double-click on the installer (Kitsu-publisher-{version}-ia32.msi) and it will install directly the app.\n\n  - The package is now in your applications.\n\n- Portable application:\n\n  - Double-click on the executable (Kitsu-publisher-{version}.exe) to run the app.\n\n- Zip portable application:\n\n  - Extract the zip (Kitsu-publisher-{version}-ia32-win.zip) by right-clicking and select \"Extract All\" and then follow the instructions.\n\n  - Double click on the executable (Kitsu publisher.exe) inside the extracted folder to run the app.\n\n#### On macOS\n\n- DMG installer:\n\n  - Double-click on the installer (Kitsu-publisher-{version}.dmg), a window should open.\n\n  - Drag and drop the Kitsu logo on the \"Applications\" folder and it will install directly the app.\n\n- PKG installer:\n\n  - To install the package (you can also install the package by double-clicking on it and following the instructions):\n\n    ```console\n    sudo installer -package Kitsu-publisher-{version}.pkg -target /\n    ```\n\n- Zip portable application:\n\n  - Double-click on the zip (Kitsu-publisher-{version}-mac.zip) to expand the zip.\n\n  - Double-click on the Kitsu publisher icon it will launch the app.\n\n### Installation of the DCCs connectors\n\n#### Pre-requisites\n\nYou need to download the connectors-{version}.zip archive in the [releases](https://github.com/cgwire/kitsu-publisher-next/releases/latest). After that, you have to unzip the archive (with right-click \"Extract All\" on Windows or unzip on Linux/macOS for example).\n\n#### Blender (version\u003e2.80)\n\n- You need to go inside the connectors/blender directory.\n\n- On Windows (with PowerShell):\n\n  - If you want to be guided through the installation of the plugin, you have to right-click on the script install.ps1 and select \"Run with PowerShell\" to run the script in prompt mode. If you have multiple installations from installer of Blender it will install the plugin for all the installations (not if you select a portable Blender).\n\n  - If you want to run the script with PowerShell command line it's possible, look at the help with:\n\n    ```console\n    .\\install.ps1 -help\n    ```\n\n- On Linux:\n\n  - If Blender is installed with a system package (for example: deb or rpm):\n\n    ```console\n    bash ./install.sh --system\n    ```\n\n  - If Blender is an unpacked directory (tar.xz archive):\n\n    ```console\n    bash ./install.sh --unpacked-directory=PATH_TO_YOUR_PORTABLE_BLENDER\n    ```\n\n  - If Blender is installed with a snap package:\n\n    ```console\n    bash ./install.sh --snap\n    ```\n\n- On macOS:\n\n  - If Blender is installed with a dmg image or Homebrew:\n\n    ```console\n    bash ./install.sh --dmg\n    ```\n\n#### Toon Boom Harmony\n\n- You need to go inside the connectors/harmony directory.\n\n- On Windows (with PowerShell):\n\n  - If you want to be guided through the installation of the plugin, you have to right-click on the script install.ps1 and select \"Run with PowerShell\" to run the script in prompt mode. If you have multiple installations from installer of Toon Boom Harmony it will install the plugin for all the installations.\n\n  - If you want to run the script with PowerShell command line it's possible, look at the help with:\n\n    ```console\n    .\\install.ps1 -help\n    ```\n\n- On macOS:\n\n  - coming soon\n\n#### Unreal Editor (version\u003e=5)\n\n- You need to go inside the connectors/unreal directory.\n\n- On Windows (with PowerShell):\n\n  - If you want to be guided through the installation of the plugin, you have to right-click on the script install.ps1 and select \"Run with PowerShell\" to run the script in prompt mode. If you have multiple installations from installer of Unreal Editor it will install the plugin for all the installations.\n\n  - If you want to run the script with PowerShell command line it's possible, look at the help with:\n\n    ```console\n    .\\install.ps1 -help\n    ```\n\n- On Linux:\n\n  - coming soon\n\n- On macOS:\n\n  - coming soon\n\n## Development Environment\n\n### Pre-requisites\n\nTo develop or to build the Electron app you need [Node.js](https://nodejs.org/en/)\u003e=16.11 installed.\n\n### Dependencies\n\nTo install all the dependencies needed by the Electron app you have to run in the project folder:\n\n```console\nnpm install\n```\n\n### Run\n\nTo run the Electron app in development mode you have to run an npm script:\n\n```console\nnpm run dev\n```\n\nIt will spawn an electron instance and a Vite development server.\n\n### Build the electron app\n\n#### Pre-requisites\n\n- On debian based Linux you need:\n\n  - To install these packages:\n\n    ```console\n    apt-get install build-essential libcairo2-dev libpango1.0-dev \\\n    libjpeg-dev libgif-dev librsvg2-dev\n    ```\n\n  - If you want to build specific target like rpm you need to install:\n\n    ```console\n    apt-get install rpm\n    ```\n\n- On Windows you need:\n\n  - See the [wiki](https://github.com/Automattic/node-canvas/wiki/Installation:-Windows) of node-canvas.\n\n- On macOS you need (with [Homebrew](https://brew.sh/)):\n\n  ```console\n  brew install pkg-config cairo pango libpng jpeg giflib librsvg\n  ```\n\n#### Building the app\n\nYou need to run npm scripts:\n\n- If you only want to build an unpackaged directory:\n\n  ```console\n  npm run build\n  ```\n\n- If you want to build for all targets:\n\n  ```console\n  npm run build:all\n  ```\n\n## Contributing\n\nAs any open source project, we enjoy any contribution! You will find below\nhow you can help the Kitsu project to get better.\n\n### Bug reports\n\nAll bugs must be submitted directly in\n[the issue page](https://github.com/cgwire/kitsu-publisher-next/issues) of this repository.\n\n### Feature requests\n\nFeature requests must be posted on our [Canny page](https://cgwire.canny.io/).\n\n### Translations\n\nIf you want to contribute to translations, you can connect directly to the\n[POEditor platform](https://poeditor.com/join/project?hash=fpUejpWDVo).\n\n### Code\n\nAll contributions are welcomed as long as they respect the [C4\ncontract](https://rfc.zeromq.org/spec:42/C4).\n\nThe Kitsu publisher code is written with Javascript (ES6) and is based on the\n[Electron](https://www.electronjs.org/) and the\n[VueJS](https://vuejs.org/v2/guide/) framework extended with the\n[Vuex](https://vuex.vuejs.org) plugin.\n\n## About authors\n\nKitsu Publisher is written by CGWire, a company based in France. We help teams of animation\nstudios to collaborate better. We provide tools to more than 50 studios spread\nall around the world.\n\nOn the technical side, we apply software craftmanship principles as much as\npossible. We love coding and consider that strong quality and good developer\nexperience matter a lot.\n\nVisit [cg-wire.com](https://cg-wire.com) for more information.\n\n[![CGWire Logo](https://zou.cg-wire.com/cgwire.png)](https://cg-wire.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcgwire%2Fkitsu-publisher-next","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcgwire%2Fkitsu-publisher-next","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcgwire%2Fkitsu-publisher-next/lists"}