Skip to content

Commit

Permalink
Update Readme and default config
Browse files Browse the repository at this point in the history
  • Loading branch information
m-wynn committed Sep 21, 2017
1 parent 8e24ec0 commit 14ba1af
Show file tree
Hide file tree
Showing 4 changed files with 18 additions and 17 deletions.
3 changes: 2 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -39,5 +39,6 @@ Makefile*
# QtCtreator CMake
CMakeLists.txt.user*


*.qmlc*

theme.conf.user
26 changes: 15 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,36 +6,40 @@ the theme.conf file.

Features:
- [x] Select user via user picker
- [x] Select user via typing in username (configuration option)
- [x] Display organization logo instead of user icon (configuration option)
- [x] Select user via typing in username (optional)
- [x] Display organization logo instead of user icon (optional)
- [x] Select background image (configuration option)
- [x] Customizable color scheme (configuration option)
- [x] Set default session (configuration option)
- [x] User selects current session via menu
- [x] Select user's session via request to your API (configuration option)
- [x] Display a usage message to the user
- [ ] Pretty icons
- [ ] Better menus for choosing user and session
- [x] Select user's session via request to your API (optional)
- [x] Display a configurable usage message to the user (optional)

## Screenshot (slightly out of date)
## Screenshots (some functionality not shown)

![Screenshot](screenshot.png)

## Configuration file values

You can create a `theme.conf.user` file which will override the defaults.

* `default_background`: Path to background image
* `default_session`: Session name to default to. This is the `sessionname` in
`/usr/share/xsessions/sessionname.desktop` (i.e. `cinnamon` or `cinnamon2d`,
NOT `Cinnamon (Software Rendering)`)
* `accent1`: The color of the top bar
* `accent2`: The color of other items, like the "LOG IN" button
* `accent2_hover`: The color that will be applied on hover to accent2 items
* `logo`: Path to the image that will be placed in the spot usually filled by a
face icon
* `logo` (optional): Path to the image that will be placed in the spot usually
filled by a face icon
* `user_name`: `fill` to have the user fill in their own username, or `select`
if you would like to provide a menu of users to choose from
* `session_api`: A url which will return the user's preferred desktop
environment (yes, this was made with a very specific use-case in mind)
* `session_api` (optional): A url which will return the user's preferred
desktop environment (yes, this was made with a very specific use-case in
mind)
* `aup` (optional): A string that will contain an Acceptable Use Policy for
your users. Escape characters such as '\n' will render properly (i.e. as
actual newlines).

### Session API

Expand Down
Binary file modified screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
6 changes: 1 addition & 5 deletions theme.conf
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,4 @@ default_session=cinnamon
accent1=#4dd0e1
accent2=#00796b
accent2_hover=#009688
logo=/usr/share/logo.png
# fill, select
user_name=fill
session_api=http://ldap-api.collegiumv.org/%s/desktopEnvironment/0
aup="[1] Unauthorized use is prohibited;\n[2] Usage may be subject to security testing and monitoring;\n[3] Misuse is subject to criminal prosecution; and\n[4] Users have no expectation of privacy except as otherwise provided by applicable privacy laws."
user_name=select

0 comments on commit 14ba1af

Please sign in to comment.