Skip to content

Commit a7bfb55

Browse files
committed
add demo gif to readme and update usage instructions
1 parent 7348841 commit a7bfb55

File tree

3 files changed

+19
-16
lines changed

3 files changed

+19
-16
lines changed

README.md

Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,18 @@
11
<img align="left" alt="Topframe" src="./topframe.png" />
22

33
# Topframe
4-
User programmable screen overlay using web technologies
4+
Webpage screen overlay using web technologies
55

66
<!-- <a href="https://goreportcard.com/report/github.com/progrium/topframe" title="Go Report Card"><img src="https://goreportcard.com/badge/github.com/progrium/topframe" alt="Go Report Card"></a> -->
77
<a href="https://twitter.com/progriumHQ" title="@progriumHQ on Twitter"><img src="https://img.shields.io/badge/twitter-@progriumHQ-55acee.svg" alt="@progriumHQ on Twitter"></a>
88
<a href="https://github.com/progrium/topframe/discussions" title="Project Forum"><img src="https://img.shields.io/badge/community-forum-ff69b4.svg" alt="Project Forum"></a>
99
<a href="https://github.com/sponsors/progrium" title="Sponsor Project"><img src="https://img.shields.io/static/v1?label=sponsor&message=%E2%9D%A4&logo=GitHub" alt="Sponsor Project" /></a>
1010

1111
---
12+
<img align="right" width="320" alt="Topframe Demo" src="./topframe.gif" />
13+
14+
* Use HTML/CSS/JS to customize your computing experience
1215
* Display information and always-on-top widgets
13-
* Use HTML/JS/CSS to draw on your screen
1416
* Edit source, hit save, screen will update
1517
* Extensible with shell scripts in any language
1618
* Less than 400 lines of Go code, minimal deps
@@ -37,32 +39,33 @@ release process with Apple code signing, etc. Specifying `GOBIN` lets you say
3739
where to install the binary, ensuring it is put in your `PATH`, but is optional if Go is more setup.
3840

3941
```
40-
$ topframe
41-
Usage: topframe <flags> <subcommand> <subcommand args>
42-
43-
Subcommands:
44-
agent fullscreen webview overlay agent
45-
docs open documentation in browser
46-
help describe subcommands and their syntax
47-
version show version
42+
$ topframe -h
43+
Usage: topframe <flags>
44+
Topframe is a fullscreen webview overlay agent
45+
46+
Flags:
47+
-docs open documentation in browser
48+
-help show help
49+
-plist generate launch agent plist
50+
-version show version
4851
```
4952

50-
To start it and show the demo webpage overlay, run `topframe agent`. This will also:
53+
To start it and show the demo webpage overlay, simply run `topframe`. This will also:
5154

5255
* create a `~/.topframe` directory with a demo `index.html` used for the overlay
5356
* watch for file changes in `~/.topframe` to trigger a page reload
5457
* add a menu bar extra (🔲) to control the overlay
5558

56-
If you edit `~/.topframe/index.html` and hit save, changes will reflect immediately. If you hate the demo content of the default `index.html`, change it! Use **Show Source...** from the menu extra to quickly
59+
If you edit `~/.topframe/index.html` and hit save, changes will reflect immediately. If you hate the demo content of the default `index.html`, change it! Use **Show Source** from the menu extra to quickly
5760
open your topframe directory.
5861

5962
### Launching on Startup
6063

6164
Topframe works with `launchd` to run as a background agent on startup. You can generate
62-
an agent plist file with `topframe agent -plist`, which you can write to a file in `~/Library/LaunchAgents`:
65+
an agent plist file with `topframe -plist`, which you can write to a file in `~/Library/LaunchAgents`:
6366

6467
```
65-
$ topframe agent -plist > ~/Library/LaunchAgents/com.progrium.Topframe.plist
68+
$ topframe -plist > ~/Library/LaunchAgents/com.progrium.Topframe.plist
6669
```
6770

6871
It's a good idea to view the output before writing to the file, just to make sure

data/index.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
}
1111
</style>
1212
</head>
13-
<body class="text-white">
13+
<body class="text-white overflow-hidden">
1414
<div id="leftskull" class="absolute left-2 top-8 draggable"><img src="/-/data/smoking-skull.gif" /></div>
1515
<div id="rightskull" class="absolute right-2 top-8 draggable"><img src="/-/data/smoking-skull.gif" /></div>
1616

@@ -29,7 +29,7 @@
2929
</script>
3030

3131

32-
<video id="zombo-src" class="absolute bottom-0 w-3/12 hidden" src="/-/data/topframe.mp4" controls autoplay></video>
32+
<video id="zombo-src" class="absolute bottom-0 w-3/12 hidden" src="/-/data/topframe.mp4" controls loop autoplay></video>
3333
<canvas id="zombo-dst" class="absolute bottom-0 w-3/12 draggable"></canvas>
3434
<script src="/-/data/chromagl.js"></script>
3535
<script>

topframe.gif

5.28 MB
Loading

0 commit comments

Comments
 (0)