{"id":16913494,"url":"https://github.com/camchenry/shaderview","last_synced_at":"2025-04-11T16:14:39.735Z","repository":{"id":82478353,"uuid":"91765512","full_name":"camchenry/shaderview","owner":"camchenry","description":"A GLSL shader development tool for the LÖVE game framework.","archived":false,"fork":false,"pushed_at":"2018-04-10T20:37:52.000Z","size":1356,"stargazers_count":26,"open_issues_count":2,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-25T12:21:43.419Z","etag":null,"topics":["glsl","love2d","lua","shaders"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/camchenry.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2017-05-19T04:29:14.000Z","updated_at":"2025-02-08T02:46:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"3a4cbee7-3dea-4997-a42a-b6bd452899ea","html_url":"https://github.com/camchenry/shaderview","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camchenry%2Fshaderview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camchenry%2Fshaderview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camchenry%2Fshaderview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/camchenry%2Fshaderview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/camchenry","download_url":"https://codeload.github.com/camchenry/shaderview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248438515,"owners_count":21103410,"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":["glsl","love2d","lua","shaders"],"created_at":"2024-10-13T19:13:37.611Z","updated_at":"2025-04-11T16:14:39.725Z","avatar_url":"https://github.com/camchenry.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"shaderview\n==========\n\nA shader development and viewing tool for the LÖVE game framework.\n\n![](https://user-images.githubusercontent.com/1514176/32976020-9c7dfcc0-cbdc-11e7-9966-f98c3fd46500.png)\n\n## Features\n\n* Automatic file reloading - Your app/shaders/textures will automatically reload when changes are detected.\n* Robust error handling - Even when your app or shader crashes, Shaderview won't. Shaderview will gracefully recover when you fix the error.\n![](https://user-images.githubusercontent.com/1514176/32976048-62953dce-cbdd-11e7-8ade-120b4662f019.png)\n* Debug tools - View project info, performance data, and textures all inside the integrated debug GUI.\n\n## How to use\n\nShaderview creates and loads projects from a save directory, which can be found using [love.filesystem.getSaveDirectory](https://love2d.org/wiki/love.filesystem.getSaveDirectory). In this document, the save directory will be referred to as `save/`.\n\nWhen you create a project it is placed inside of `save/projects/`. For example, if you make a project called \"my_shader\" then the associated project folder will be `save/projects/my_shader`. The structure of a project folder looks like this:\n\n* `project/`\n  * `app/` \n    * `main.lua`\n  * `shaders/`\n  * `textures/`\n\n### App\nThe `app/main.lua` file is the core of your application, where you can send variables to shaders, create canvases, and set the active shader. It is much like a normal LÖVE main.lua file, except it defines functions in a module rather than in the global table. The normal LÖVE callbacks can be easily translated to this format. For example, `love.keypressed` becomes `app:keypressed`, `love.update` becomes `app:update` and so on. The arguments remain the same and are simply passed into your application code as they would be normally. When this file changes, it will be reloaded automatically.\n\n### Shaders\nThe `shaders/` directory is where you place all of your shader files. Shaders inside of this directory will be loaded into a global table called `shaders` where the key is the name of the file (without the extension) and the value is the created Shader. For example, `shaders/my_shader.frag` becomes `shaders.my_shader` or `shaders['my_shader']`. Whenever you change a shader, it will be reloaded automatically.\n\n### Textures\nThe `textures/` directory is where you place all of your textures. Textures in this directory will be loaded into a global table called `textures` where the key is the name of the file (without the extension) and the value is the created [Image](https://love2d.org/wiki/Image). For example, `textures/my_texture.png` becomes `textures.my_texture` or `textures['my_texture']`. Whenever you change a texture, it will be reloaded automatically.\n\n## Configuration\n\nThe default configuration file for Shaderview is `save/config/default.lua` and the user configuration file is `save/config/user.lua`. The user configuration file will overwrite any properties set in the default file. When either the default or user configuration is modified, it will be reloaded.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcamchenry%2Fshaderview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcamchenry%2Fshaderview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcamchenry%2Fshaderview/lists"}