{"id":15107621,"url":"https://github.com/juliendelplanque/mirage","last_synced_at":"2025-10-09T17:11:43.692Z","repository":{"id":83914500,"uuid":"61238085","full_name":"juliendelplanque/Mirage","owner":"juliendelplanque","description":"A windows switcher with a previewer for Pharo.","archived":false,"fork":false,"pushed_at":"2019-04-18T19:11:50.000Z","size":1138,"stargazers_count":34,"open_issues_count":4,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-01-30T17:11:19.499Z","etag":null,"topics":["mirage","pharo","previewer","windows-switcher"],"latest_commit_sha":null,"homepage":null,"language":"Smalltalk","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/juliendelplanque.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}},"created_at":"2016-06-15T20:16:51.000Z","updated_at":"2023-10-31T06:34:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"e6966c56-1705-4841-8da8-1fe71ada459d","html_url":"https://github.com/juliendelplanque/Mirage","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliendelplanque%2FMirage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliendelplanque%2FMirage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliendelplanque%2FMirage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juliendelplanque%2FMirage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juliendelplanque","download_url":"https://codeload.github.com/juliendelplanque/Mirage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237769067,"owners_count":19363250,"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":["mirage","pharo","previewer","windows-switcher"],"created_at":"2024-09-25T21:40:29.172Z","updated_at":"2025-10-09T17:11:38.668Z","avatar_url":"https://github.com/juliendelplanque.png","language":"Smalltalk","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Mirage [![Build Status](https://travis-ci.org/juliendelplanque/Mirage.svg?branch=master)](https://travis-ci.org/juliendelplanque/Mirage)\n![Demo](https://raw.githubusercontent.com/juliendelplanque/Mirage/dev/misc/gif/demo.gif)\n\n# Install\n## Stable version\nTo install the stable version, you can simply use the **Catalog browser** and search for 'WindowsPreviewer'\nor evaluate the following code snippet:\n\n### Pharo 6.1\n~~~\nMetacello new\n    repository: 'github://JulienDelplanque/Mirage:v1.0.0/src';\n    baseline: 'Mirage';\n    load\n~~~\n\n### Pharo 7.x\n~~~\nMetacello new\n    repository: 'github://JulienDelplanque/Mirage:v2.1.0/src';\n    baseline: 'Mirage';\n    load\n~~~\n\n## Development version (Pharo 8.0)\nSimply evaluate the following code snippet:\n~~~\nMetacello new\n    repository: 'github://JulienDelplanque/Mirage:dev/src';\n    baseline: 'Mirage';\n    load\n~~~\n\n## Version management \n\nThis project use semantic versionning to define the releases. This mean that each stable release of the project will get associate a version number of the form `vX.Y.Z`. \n\n- **X** define the major version number\n- **Y** define the minor version number \n- **Z** define the patch version number\n\nWhen a release contains only bug fixes, the patch number increase. When the release contains new features backward compatibles, the minor version increase. When the release contains breaking changes, the major version increase. \n\nThus, it should be safe to depend on a fixed major version and moving minor version of this project.\n\n# Setup\nGo to the 'Settings browser' and check the 'Activate' button in 'Mirage' subgroup of 'Tools' group.\nThen, you can choose the view you want to use by checking the buttons corresponding.\n\n- If the default shortcut to open the previewer does not fit with you, you can change it from settings as well.\n- It is also possible to change the order used to display windows in the previewer by selecting one the method in \"Windows management\" setting.\n\n![Settings browser](https://raw.githubusercontent.com/juliendelplanque/Mirage/dev/misc/img/settings.png)\n\n# How to use\nOnce you activated **Mirage** in the 'Settings browser' hit 'Ctrl+Tab' to open the previewer.\nYou can now use left/right arrow to choose a window and hit the space key to open it.\n\n| Key                  | Purpose                                                                   |\n|:---------------------|:--------------------------------------------------------------------------|\n| (Ctrl/Shift)+Tab     | Open the previewer (Ctrl for Linux, Shift for Windows and Mac OS).        |\n| Left arrow           | Select window on the left of the current window.                          |\n| Right arrow/Tab      | Select the window on the right of the current window.                     |\n| Space/Enter          | Set the window selected in the previewer on top.                          |\n| Esc                  | Quit the windows previewer without changing the current window.           |\n\n# Developers documentation\nThe [wiki](https://github.com/juliendelplanque/Mirage/wiki) holds all the documentation needed to contribute to the project.\n\nIf you want to contribute to this project, please follow the [contribution guidelines](https://github.com/juliendelplanque/Mirage/wiki/How-to-contribute).\n\nHere are some useful links:\n- [Creating your own view](https://github.com/juliendelplanque/Mirage/wiki/How-to-extend-WP#creating-you-own-view)\n- [Add a windows ordering method](https://github.com/juliendelplanque/Mirage/wiki/How-to-extend-WP#add-a-windows-ordering-method)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliendelplanque%2Fmirage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuliendelplanque%2Fmirage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliendelplanque%2Fmirage/lists"}