{"id":13680908,"url":"https://github.com/stuffmatic/fSpy","last_synced_at":"2025-04-30T02:33:36.158Z","repository":{"id":39757132,"uuid":"137477588","full_name":"stuffmatic/fSpy","owner":"stuffmatic","description":"A cross platform app for quick and easy still image camera matching","archived":false,"fork":false,"pushed_at":"2022-12-08T17:16:22.000Z","size":75155,"stargazers_count":2238,"open_issues_count":102,"forks_count":215,"subscribers_count":82,"default_branch":"develop","last_synced_at":"2024-10-29T17:49:29.212Z","etag":null,"topics":["3d-graphics","blender","camera-calibration","fspy"],"latest_commit_sha":null,"homepage":"https://fspy.io","language":"TypeScript","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/stuffmatic.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}},"created_at":"2018-06-15T11:02:37.000Z","updated_at":"2024-10-29T01:00:53.000Z","dependencies_parsed_at":"2023-01-25T15:00:56.748Z","dependency_job_id":null,"html_url":"https://github.com/stuffmatic/fSpy","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuffmatic%2FfSpy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuffmatic%2FfSpy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuffmatic%2FfSpy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stuffmatic%2FfSpy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stuffmatic","download_url":"https://codeload.github.com/stuffmatic/fSpy/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224188061,"owners_count":17270366,"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":["3d-graphics","blender","camera-calibration","fspy"],"created_at":"2024-08-02T13:01:23.654Z","updated_at":"2024-11-12T00:30:16.635Z","avatar_url":"https://github.com/stuffmatic.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"## What is this?\n\nfSpy is an open source, cross platform app for still image camera matching. See [fspy.io](https://fspy.io) for more info. The source code is available under the GPL license.\n\n![fSpy screenshot](screenshot.jpg)\n\n## Backstory\n\nOnce upon a time I wrote BLAM, a [Blender](https://blender.org) add-on for still image camera calibration that, despite its clunky UI, has gained some popularity in the Blender community. fSpy is an attempt to bring BLAM's functionality to a wider audience in the form of a stand alone app.\n\n## Using the computed camera parameters in other applications\n\nIn theory, camera parameters computed by fSpy could be used in any application that has a notion of a 3D camera and provides some way of setting the camera parameters. If you're a Blender user, have a look at the [offical fSpy importer add-on](https://github.com/stuffmatic/fSpy-Blender). If you're using an application without a dedicated importer, you may still be able to manually copy the camera parameters from fSpy.\n\nInterested in writing an importer for your favorite application? Then the [fSpy project file format spec](https://github.com/stuffmatic/fSpy/blob/develop/project_file_format.md) is a good starting point.\n\n\n## Building and running\n\nThe following instructions are for developers. If you just want to run the app, [download the latest executable for your platform](https://github.com/stuffmatic/fSpy/releases).\n\nfSpy is written in [Typescript](https://www.typescriptlang.org) using [Electron](https://electronjs.org), [React](https://reactjs.org) and [Redux](https://redux.js.org). [Visual Studio Code](https://code.visualstudio.com) is recommended for a pleasant editing experience.\n\nTo install necessary dependencies, run\n\n```\nyarn\n```\n\nThe `src` folder contains two subfolders `main` and `gui`, containing code for the [Electron main and renderer processes](https://electronjs.org/docs/tutorial/application-architecture) respectively.\n\nHere's how to run the app in development mode\n\n1. Run `yarn dev-server` in a separate terminal tab to start the dev server\n2. Run `yarn build-dev` to build both the main and GUI code. This build step is needed to generate main process code used to start up the app.\n3. Run `yarn electron-dev` in a separate terminal tab to start an Electron instance which uses the dev server to provide automatic reloading on GUI code changes.\n\n⚠️ The current build process is not ideal. For example, it lacks support for live reloading on main process code changes. Changes to main process code require a manual rebuild, i.e steps 2-3, in order to show up in the app.\n\n\n## Creating binaries for distribution\n\nTo create executables for distribution, run\n\n```\nyarn dist\n```\n\nwhich invokes [Electron builder](https://github.com/electron-userland/electron-builder).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuffmatic%2FfSpy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstuffmatic%2FfSpy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstuffmatic%2FfSpy/lists"}