aboutsummaryrefslogtreecommitdiff
path: root/doc/troubleshooting.html
blob: d77e45b276a8c3e3944369885e0eafeadd46301f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
<!DOCTYPE html>
<html>
<head>
<title>QMidiPlayer Help</title>
<link rel=stylesheet href='styles.css' type='text/css'>
</head>
<body>
	<div id="panel">
		<ul>
			<li><a href="index.html">Overview</a></li>
			<li><a href="mainwindow.html">Main Window</a></li>
			<li><a href="channeldialog.html">Channels Dialog</a></li>
			<li><a href="channeleditor.html">Channel Editor</a></li>
			<li><a href="plistdialog.html">Playlist</a></li>
			<li><a href="efxdialog.html">Effects</a></li>
			<li><a href="optionsdialog.html">Settings</a></li>
			<li><a href="visualization.html">Visualization</a></li>
			<li><a href="cmdargs.html">Commandline arguments</a></li>
			<li><a class="active" href="troubleshooting.html">Troubleshooting</a></li>
			<li><a href="miscellaneous.html">Miscellaneous</a></li>
			<li><a href="version.html">Version Info.</a></li>
			<li><a href="license.html">License</a></li>
		</ul>
	</div>
	<div id="content">
		If troubleshooting cannot solve your problem, please don't hesitate to report an issue.
		<h3>1. I can't hear anything!</h3>
		<p>
			<ol>
			<li>Check current audio driver in the option dialog. Do not use an audio driver
			that is not installed on your system.</li>
			<li>If no soundfont is loaded, the internal synthesizer won't make any sound...</li>
			<li>Check audio driver/buffer settings in the synth section.</li>
			<li>Check if your midi file is valid/having correct bank selecting method<s>/having zero volume</s>.</li>
			</ol>
		</p>
		<h3>2. The playback is intermittent.</h3>
		<p>
			Try increasing audio buffer size and/or audio buffer count in synth options.
		</p>
		<h3>3. MIDI timing is messed up.</h3>
		<p>
			This is a known issue under Windows. Try decreasing audio buffer size and
			increasing audio buffer count. Also make sure you are not using shitty cabling
			if you are using external synthesizers.
		</p>
		<p>
			Also also, if you overload your computer (fluidsynth) or synthesizer too much,
			don't expect the timing would still keep up!
		</p>
		<h3>4. Some files cannot be played.</h3>
		<h3>5. Some soundfonts cannot be loaded.</h3>
		<p>
			Files names with characters unsupported by the system locale
			won't load correctly in Windows. This is a known issue.
		</p>
		<h3>6. Sound is distorted.</h3>
		<p>
			Try reducing the master volume.
		</p>
		<h3>7. Bank selecting is incorrect for the internal synth.</h3>
		<p>
			Change default midi mapping if necessary.
		</p>
		<h3>8. Bank selecting is incorrect for external devices.</h3>
		<p>
			Bank selecting messages are sent to external devices directly. The midi
			file may be incompatible with your device.
		</p>
		<h3>9. 3D visualization is upsidedown/rotated/black/blinking.</h3>
		<p>
			For those who see a rotated and blinking display, try setting
			Visualization-Video/Multisampling to 1 or above. If that doesn't
			solve your problem or you see nothing at all, please send me more
			details about your problem (graphics card, drivers etc.).
		</p>
		<p>
			Devices/drivers reported to have this issue:
			<ul>
				<li>Intel HD 5500 found in i5-5200U / official Windows driver</li>
				<li>Unknown low-end AMD Oland GPU / official Windows driver</li>
				<li>Raspberry Pi 2 &amp; 3 VC4 / Full KMS OpenGL (GLX)</li>
			</ul>
		</p>
		<h3>10. External devices connected but does not show up.</h3>
		<p>
			Always connect your device <b>before</b> launching QMidiPlayer and make
			sure it is not used by another application.
			If it still refuses to work, make sure your device is working within
			some other MIDI applications. If it doesn't, try reinstalling the driver,
			checking the cables ... even turning it off and on again?
		</p>
		<p>
			If it works in programs other than QMidiPlayer however, you're probably
			facing a new bug in QMidiPlayer.
		</p>
		<h3>11. Tweaking the values in channel editor does nothing.</h3>
		<p>
			It depends. Sound modules from different vendors accept different sets
			of controller messages. As for fluidsynth, it relies on the modulation
			matrix of the soundfont. Sadly most of the soundfonts floating around
			on the Internet do not have modulation matrix declared.
		</p>
	</div>
</body>
</html>